The special type "ncgstr
" is used to specify a char string that is
transferred between client and server. It becomes "char *
" in the
generated code.
"ncgstr *
" it used to specify a list of strings terminated by an empty
string and becomes "char **
".
"ncgstr **
" specifies a list of lists terminated by an empty list
(a list containing only an empty string) and becomes "char ***
".
The lists are transferred in their entirety between client and server.
Strings and all items in a list are malloc()
'd, including the
terminating empty string. The lists are also malloc()
'd arrays of
pointers. They should be freed accordingly as required.
The functions freelst()
and freelstlst()
are provided for
easy freeing of lists. See the Support Functions section.