User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |

---

   strsep    ( 3 )

---

---

Имя (Name)

strsep - extract token from string

---

Синопсис (Synopsis)

#include <string.h>

       char *strsep(char **restrict stringp, const char *restrict delim);

   Feature Test Macro Requirements for glibc (see
   feature_test_macros(7)):

       strsep():
           Since glibc 2.19:
               _DEFAULT_SOURCE
           Glibc 2.19 and earlier:
               _BSD_SOURCE

---

Описание (Description)

If *stringp is NULL, the strsep() function returns NULL and does
       nothing else.  Otherwise, this function finds the first token in
       the string *stringp, that is delimited by one of the bytes in the
       string delim.  This token is terminated by overwriting the
       delimiter with a null byte ('\0'), and *stringp is updated to
       point past the token.  In case no delimiter was found, the token
       is taken to be the entire string *stringp, and *stringp is made
       NULL.

---

Возвращаемое значение (Return value)

The strsep() function returns a pointer to the token, that is, it
       returns the original value of *stringp.

---

Атрибуты (Attributes)

For an explanation of the terms used in this section, see
       attributes(7).

       ┌──────────────────────────────────────┬───────────────┬─────────┐
       │Interface                             │ Attribute     │ Value   │
       ├──────────────────────────────────────┼───────────────┼─────────┤
       │strsep()                              │ Thread safety │ MT-Safe │
       └──────────────────────────────────────┴───────────────┴─────────┘

---

Стандарты (Conforming to)

4.4BSD.

---

Примечание (Note)

The strsep() function was introduced as a replacement for
       strtok(3), since the latter cannot handle empty fields.  However,
       strtok(3) conforms to C89/C99 and hence is more portable.

---

Ошибки (баги) (Bugs)

Be cautious when using this function.  If you do use it, note
       that:

       * This function modifies its first argument.

       * This function cannot be used on constant strings.

       * The identity of the delimiting character is lost.

---

Смотри также (See also)

index(3), memchr(3), rindex(3), strchr(3), string(3), strpbrk(3),
       strspn(3), strstr(3), strtok(3)

---