NAME

concat_word_lists - Concatenates an array of word lists

SYNOPSIS

#include "l/l_word_list.h"

Example compile flags (system dependent):
  -DLINUX_X86_64 -DLINUX_X86_64_OPTERON  -DGNU_COMPILER 
   -I/home/kobus/include
   -L/home/kobus/misc/load/linux_x86_64_opteron -L/usr/lib/x86_64-linux-gnu
  -lKJB                               -lfftw3  -lgsl -lgslcblas -ljpeg  -lSVM -lstdc++                    -lpthread -lSLATEC -lg2c    -lacml -lacml_mv -lblas -lg2c      -lncursesw 


int concat_word_lists
(
	Word_list **target_word_list_ptr_ptr,
	int num_word_lists,
	const Word_list *const *word_list_ptr_array
);

DESCRIPTION

The routine concatenates an array of word lists, into a target word list which is created or resized as needed to hold the result. Note that if the input lists contain empty entries, they are preserved in the order they appear! Also note that function append_word_list() freely adds empty entries at the end of lists. If that is undesirable, use function trim_word_list_empty_entries_at_tail() on the input lists, prior to calling this function.

RETURNS

NO_ERROR on success, and ERROR on failure, with an appropriate error message being set.

DISCLAIMER

This software is not adequatedly tested. It is recomended that results are checked independantly where appropriate.

AUTHOR

Kobus Barnard

DOCUMENTER