colinit - initialize a row structure
SYNOPSIS
DESCRIPTION
colinit
initializes the structure pointed to by
row
and allocates sufficient storage for
the arrays and buffers it contains.
It is called by
colgetr()
and thus does not need to be called
directly by programs which use
colgetr()
or
colgeth().
If the
row
structure has already been initialized,
colinit
returns without doing anything.
The
rowstruct
elements
row->fs
and
row->p_filein
must be set and/or opened prior to invocation of
colinit,
if their default values are not
TAB
and
stdin,
respectively.
RETURN VALUE
colinit
returns -1 if it can't allocate storage for
row;
otherwise it returns 0.
SEE ALSO