NAME

xt_dsv_read_field_malloc() - Read next field from tabular input, allocating memory as needed

LIBRARY

#include <xtend/dsv.h>
-lxtend

SYNOPSIS

int     xt_dsv_read_field_malloc(FILE *stream, char **buff, size_t *buff_size,
const char *delims, size_t *len)

ARGUMENTS

stream      FILE stream from which field is read
buff        Character buffer into which field is copied
buff_size   Size of the array passed to buff
delims      Array of characters that may serve as delimiters
len         Pointer to a variable which will receive the field length

DESCRIPTION

Read next delimiter-separated field from stream, allocating a buffer to fit in the fashion of strdup(3). The fields may be ended by any character in the string delims or by a newline ('\n').

If the delimiter ending a field is a space, then subsequence spaces are discarded, so that multiple space characters serve as a single delimiter.

*buff_size indicates the size of the existing array, if one is already allocated. If *buff does not point to an allocated array, this should be 0, i.e. pass the address of a variable containing 0, not NULL. *buff_size will be updated if the array needs to be expanded to accommodate the new input.

RETURN VALUES

Delimiter ending the field (either a member of delim or newline) or XT_MALLOC_FAILED.

SEE ALSO

xt_dsv_read_field(3), xt_dsv_skip_field(3), xt_dsv_skip_rest_of_line(3), xt_dsv_line_read(3)