FreeBSD manual
download PDF document: findline.3.pdf
FINDLINE(3) Schily's LIBRARY FUNCTIONS FINDLINE(3)
NAME
findline() - finds a line that has a matching field
SYNOPSIS
int findline(fname,delim,string,field,array,arraysize)
char *fname; /* file name */
char delim; /* field delimiter */
char *string; /* string to match */
int field; /* field number to match, 0-n */
char *array[]; /* array to fill pointers in */
int arraysize; /* number of entries in the arrays */
DESCRIPTION
findline() retrieves specific fields from the first line of the file
fname.
findline() fills in array with pointers to strings that make up the
fields on the line. The strings are allocated new storage. The field
delimiter, delim, is used to break up each line of the file into
fields. string is the string to match. fieldno is the field number to
match. Fields are numbered 0..n. array is an array of pointers to fill
in. arraysize is the number of elements in the array.
RETURNS
+1 match.
-1 no match.
-2 arg error.
-3 cannot open file.
-4 not enough memory to allocate space for fields.
NOTES
Each line of the file must be less than 512 characters long.
Joerg Schilling 2022/09/09 FINDLINE(3)