Movatterモバイル変換

wcstok(3) — Linux manual page

NAME \|LIBRARY \|SYNOPSIS \|DESCRIPTION \|RETURN VALUE \|ATTRIBUTES \|STANDARDS \|HISTORY \|NOTES \|EXAMPLES \|SEE ALSO \|COLOPHON

wcstok(3)                Library Functions Manualwcstok(3)

NAME top

       wcstok - split wide-character string into tokens

LIBRARY top

       Standard C library (libc,-lc)

SYNOPSIS top

#include <wchar.h>wchar_t *wcstok(wchar_t *restrictwcs, const wchar_t *restrictdelim,wchar_t **restrictptr);

DESCRIPTION top

       Thewcstok() function is the wide-character equivalent of thestrtok(3) function, with an added argument to make it multithread-       safe.  It can be used to split a wide-character stringwcs into       tokens, where a token is defined as a substring not containing any       wide-characters fromdelim.       The search starts atwcs, ifwcs is not NULL, or at*ptr, ifwcs       is NULL.  First, any delimiter wide-characters are skipped, that       is, the pointer is advanced beyond any wide-characters which occur       indelim.  If the end of the wide-character string is now reached,wcstok() returns NULL, to indicate that no tokens were found, and       stores an appropriate value in*ptr, so that subsequent calls towcstok() will continue to return NULL.  Otherwise, thewcstok()       function recognizes the beginning of a token and returns a pointer       to it, but before doing that, it zero-terminates the token by       replacing the next wide-character which occurs indelim with a       null wide character (L'\0'), and it updates*ptr so that       subsequent calls will continue searching after the end of       recognized token.

RETURN VALUE top

       Thewcstok() function returns a pointer to the next token, or NULL       if no further token was found.

ATTRIBUTES top

       For an explanation of the terms used in this section, seeattributes(7).       ┌──────────────────────────────────────┬───────────────┬─────────┐       │Interface│Attribute│Value│       ├──────────────────────────────────────┼───────────────┼─────────┤       │wcstok()                             │ Thread safety │ MT-Safe │       └──────────────────────────────────────┴───────────────┴─────────┘

STANDARDS top

       C11, POSIX.1-2008.

HISTORY top

       POSIX.1-2001, C99.

NOTES top

       The originalwcs wide-character string is destructively modified       during the operation.

EXAMPLES top

       The following code loops over the tokens contained in a wide-       character string.       wchar_t *wcs = ...;       wchar_t *token;       wchar_t *state;       for (token = wcstok(wcs, L" \t\n", &state);           token != NULL;           token = wcstok(NULL, L" \t\n", &state)) {           ...       }

COLOPHON top

       This page is part of theman-pages (Linux kernel and C library       user-space interface documentation) project.  Information about       the project can be found at        ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report       for this manual page, see       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.       This page was obtained from the tarball man-pages-6.15.tar.gz       fetched from       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on       2025-08-11.  If you discover any rendering problems in this HTML       version of the page, or you believe there is a better or more up-       to-date source for the page, or you have corrections or       improvements to the information in this COLOPHON (which isnot       part of the original manual page), send a mail to       man-pages@man7.orgLinux man-pages 6.15            2025-05-17wcstok(3)

Pages that refer to this page:strtok(3), signal-safety(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface.

For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere.

Hosting byjambit GmbH.