diff options
Diffstat (limited to 'manual/string.texi')
| -rw-r--r-- | manual/string.texi | 25 |
1 files changed, 13 insertions, 12 deletions
diff --git a/manual/string.texi b/manual/string.texi index 45b2bc8472..a151ddd48c 100644 --- a/manual/string.texi +++ b/manual/string.texi @@ -1331,18 +1331,19 @@ which support multi-threading. @comment string.h @comment BSD @deftypefun {char *} strsep (char **@var{string_ptr}, const char *@var{delimiter}) -This function is just @code{strtok_r} with the @var{newstring} argument -replaced by the @var{save_ptr} argument. The initialization of the -moving pointer has to be done by the user. Successive calls to -@code{strsep} move the pointer along the tokens separated by -@var{delimiter}, returning the address of the next token and updating -@var{string_ptr} to point to the beginning of the next token. - -If the input string contains more than one character from -@var{delimiter} in a row @code{strsep} returns an empty string for each -pair of characters from @var{delimiter}. This means that a program -normally should test for @code{strsep} returning an empty string before -processing it. +This function has a similar functionality as @code{strtok_r} with the +@var{newstring} argument replaced by the @var{save_ptr} argument. The +initialization of the moving pointer has to be done by the user. +Successive calls to @code{strsep} move the pointer along the tokens +separated by @var{delimiter}, returning the address of the next token +and updating @var{string_ptr} to point to the beginning of the next +token. + +One difference between @code{strsep} and @code{strtok_r} is that if the +input string contains more than one character from @var{delimiter} in a +row @code{strsep} returns an empty string for each pair of characters +from @var{delimiter}. This means that a program normally should test +for @code{strsep} returning an empty string before processing it. This function was introduced in 4.3BSD and therefore is widely available. @end deftypefun |