Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xt_ff_dsv_...ield_malloc(3) Library Functions Manual xt_ff_dsv_...ield_malloc(3)

NAME
     xt_ff_dsv_read_field_malloc()  -  Read next field from tabular input, allo-
     cating memory as needed

LIBRARY
     #include <xtend/ff-dsv.h>
     -lxtend

SYNOPSIS
     int     xt_ff_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  al-
     located.	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_MAL-
     LOC_FAILED.

SEE ALSO
     xt_ff_dsv_read_field(3),				xt_ff_dsv_skip_field(3),
     xt_ff_dsv_skip_rest_of_line(3), xt_ff_dsv_line_read(3)

						     xt_ff_dsv_...ield_malloc(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_ff_dsv_read_field_malloc&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help