From cebe22cb333877a3502c626ed98ff2983810b765 Mon Sep 17 00:00:00 2001 From: Keith Bostic Date: Mon, 14 Nov 1988 17:47:10 -0800 Subject: [PATCH] date and time created 88/11/14 09:47:10 by bostic SCCS-vsn: lib/libc/string/strtok.3 5.1 --- usr/src/lib/libc/string/strtok.3 | 59 ++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 usr/src/lib/libc/string/strtok.3 diff --git a/usr/src/lib/libc/string/strtok.3 b/usr/src/lib/libc/string/strtok.3 new file mode 100644 index 0000000000..d2d381a630 --- /dev/null +++ b/usr/src/lib/libc/string/strtok.3 @@ -0,0 +1,59 @@ +.\" Copyright (c) 1988 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms are permitted +.\" provided that the above copyright notice and this paragraph are +.\" duplicated in all such forms and that any documentation, +.\" advertising materials, and other materials related to such +.\" distribution and use acknowledge that the software was developed +.\" by the University of California, Berkeley. The name of the +.\" University may not be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED +.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" @(#)strtok.3 5.1 (Berkeley) %G% +.\" +.TH STRTOK 3 "" +.UC 3 +.SH NAME +strtok, strsep \- string token operations +.SH SYNOPSIS +.nf +.B char *strtok(str, sep) +.B char *str, *sep; +.PP +.B char *strsep(str, sep) +.B char *str, *sep; +.fi +.PP +.I Strtok +is used to isolate sequential tokens in a null-terminated string, +.IR str . +These tokens are separated in the string by +.B "one or more" +of the characters in +.IR sep . +The first time that +.I strtok +is called, +.I str +should be specified; subsequent calls, wishing to obtain further tokens +from the same string, should pass a null pointer instead. The separator +string, +.IR sep , +must be supplied each time, and may change between calls. +.I Strtok +returns a pointer to the start of each subsequent token in the string, +after replacing the token itself with a NUL character. When no more +tokens remain, a null pointer is returned. +.PP +.I Strsep +behaves similarly to +.I strtok +with the exception that the tokens in the string are separated by single +occurrences of separator characters. This routine was added to allow +handling blank fields. +.SH BUGS +There is no way to get tokens from multiple strings simultaneously. -- 2.20.1