Charles.Forsyth20060303-partialeea662d19 years agoHistory
76 lines · 1.3 KB · Text
RawDownload
.TH GETFIELDS 10.2.SH NAMEgetfields, tokenize \- break a string into fields.SH SYNOPSIS.ta \w'\fLchar* \fP'u.Bint	getfields(char *str, char **args, int maxargs, int multiflag,.br.B	    char *delims).PP.Bint	tokenize(char *str, char **args, int maxargs).SH DESCRIPTION.I Getfieldsbreaks the null-terminated.SM UTFstring.I strinto at most.I maxargsnull-terminated fields and places pointers to the start of these fields in the array.IR args .Some of the bytes in.I strare overwritten.If there are more than.I maxargsfields,only the first.I maxargsfields will be set..I Delimsis a.SM UTFstring defining a set of delimiters..PPIf.I multiflagis zero,adjacent fields are separated by exactly one delimiter.A string containing.I ndelimiter characterscontains.IR n +1fields.If the.I multiflagargument is not zero,a field is a non-empty string of non-delimiters..PPGetfieldsreturn the number of tokens processed..PP.I Tokenizeis the same as.I getfieldswith.I multiflagnon-zero and.I delims\f5"\et\er\en "\fP,except that fields may be quoted using single quotes, in the mannerofthe command interpreter..SH SOURCE.B /libkern/getfields.c.br.B /libkern/tokenize.c.br.B /lib9/getfields.c.br.B /lib9/tokenize.c.SH SEE ALSO.IR strcat (10.2)