.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" References consulted:
.\"   GNU glibc-2 source code and manual
.\"   Dinkumware C library reference http://www.dinkumware.com/
.\"   OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html
.\"   ISO/IEC 9899:1999
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH wcstok 3 "31 октября 2023 г." "Linux man\-pages 6.06" 
.SH ИМЯ
wcstok \- разделяет широкосимвольную строку на элементы (токены)
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *wcstok(wchar_t *restrict \fP\fIwcs\fP\fB, const wchar_t *restrict \fP\fIdelim\fP\fB,\fP
\fB                wchar_t **restrict \fP\fIptr\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Функция \fBwcstok\fP() является эквивалентом функции \fBstrtok\fP(3) для
широкосимвольных строк, но к ней добавлен аргумент для поддержки работы в
нитях. Она может использоваться для разбиения широкосимвольной строки \fIwcs\fP
на элементы, где элементом считается подстрока, не включающая в себя широкие
символы из строки \fIdelim\fP.
.P
The search starts at \fIwcs\fP, if \fIwcs\fP is not NULL, or at \fI*ptr\fP, if \fIwcs\fP
is NULL.  First, any delimiter wide\-characters are skipped, that is, the
pointer is advanced beyond any wide\-characters which occur in \fIdelim\fP.  If
the end of the wide\-character string is now reached, \fBwcstok\fP()  returns
NULL, to indicate that no tokens were found, and stores an appropriate value
in \fI*ptr\fP, so that subsequent calls to \fBwcstok\fP()  will continue to return
NULL.  Otherwise, the \fBwcstok\fP()  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 in \fIdelim\fP with
a null wide character (L\[aq]\e0\[aq]), and it updates \fI*ptr\fP so that
subsequent calls will continue searching after the end of recognized token.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBwcstok\fP() возвращает указатель на следующий элемент или NULL, если
больше элементов не найдено.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBwcstok\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001, C99.
.SH ЗАМЕЧАНИЯ
Исходная широкосимвольная строка \fIwcs\fP может измениться в процессе работы
функции.
.SH ПРИМЕРЫ
Следующий код в ходе работы цикла выводит все элементы, содержащиеся в
широкосимвольной строке.
.P
.EX
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, L" \et\en", &state);
    token != NULL;
    token = wcstok(NULL, L" \et\en", &state)) {
    ...
}
.EE
.SH "СМ. ТАКЖЕ"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Azamat Hackimov <azamat.hackimov@gmail.com>
и
Yuri Kozlov <yuray@komyakino.ru>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .