.\" -*- coding: UTF-8 -*-
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\" %%%LICENSE_END
.\"
.\" 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 "9 junho 2020" GNU "Manual do Programador do Linux"
.SH NOME
wcstok \- separa uma string de caracteres largos em tokens
.SH SINOPSE
.nf
\fB#include <wchar.h>\fP
.PP
\fBwchar_t *wcstok(wchar_t *\fP\fIwcs\fP\fB, const wchar_t *\fP\fIdelim\fP\fB, wchar_t **\fP\fIptr\fP\fB);\fP
.fi
.SH DESCRIÇÃO
A função \fBwcstok\fP() é o equivalente de caracteres largos da função
\fBstrtok\fP(), com um argumento adicional para torná\-la segura para
multithread. Ela pode ser usada para separar uma string de caracteres largos
\fIwcs\fP em tokens, onde um token é definido como uma substring que não contém
nenhum dos caracteres largos de \fIdelim\fP.
.PP
A busca inicia em \fIwcs\fP, se \fIwcs\fP não é NULO, ou em \fI*ptr\fP, se \fIwcs\fP é
NULO. Primeiramente, quaisquer caracteres largos delimitadores são pulados,
ou seja o ponteiro é avançado além de quaisquer caracteres largos que
ocorrem em \fIdelim\fP. Se o fim da string de caracteres largos é alcançado
neste momento, \fBwcstok\fP() retorna NULO, para indicar que nenhum token foi
encontrado, e guarda um valor apropriado em \fI*ptr\fP, de forma que chamadas
subsequentes a \fBwcstok\fP() continuarão retornando NULO. Caso contrário, a
função \fBwcstok\fP() reconhece o início de um token e retorna um ponteiro para
ele, mas antes de fazê\-lo, ela termina com zero o token, substituindo o
próximo caractere largo que ocorre em \fIdelim\fP com um caractere
(L\(aq\e0\(aq), e ela atualiza \fI*ptr\fP de forma que as chamadas subsequentes
continuarão a busca depois do fim do token reconhecido.
.SH "VALOR DE RETORNO"
A função \fBwcstok\fP() retorna um ponteiro para o próximo token, ou NULO se
nenhum token adicional foi encontrado.
.SH ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte
\fBattributes\fP(7).
.TS
allbox;
lb lb lb
l l l.
Interface	Atributo	Valor
T{
\fBwcstok\fP()
T}	Thread safety	MT\-Safe
.TE
.SH "DE ACORDO COM"
POSIX.1\-2001, POSIX.1\-2008, C99.
.SH NOTAS
A string de caracteres largos original \fIwcs\fP é modificada destrutivamente
durante a operação.
.SH EXEMPLOS
O seguinte código percorre os tokens contidos numa string de caracteres
largos.
.PP
.EX
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, " \et\en", &state);
    token != NULL;
    token = wcstok(NULL, " \et\en", &state)) {
    ...
}
.EE
.SH "VEJA TAMBÉM"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.SH COLOFÃO
Esta página faz parte da versão 5.10 do projeto Linux \fIman\-pages\fP. Uma
descrição do projeto, informações sobre relatórios de bugs e a versão mais
recente desta página podem ser encontradas em
\%https://www.kernel.org/doc/man\-pages/.
.PP
.SH TRADUÇÃO
A tradução para português brasileiro desta página man foi criada por
Felipe M Pereira <Felipe.Pereira@ic.unicamp.br>,
André Luiz Fassone <lonely_wolf@ig.com.br>
e
Rafael Fontenelle <rafaelff@gnome.org>.
.
.PP
Esta tradução é uma documentação livre; leia a
.UR https://www.gnu.org/licenses/gpl-3.0.html
Licença Pública Geral GNU Versão 3 
.UE
ou posterior para as condições de direitos autorais.
Nenhuma responsabilidade é aceita.
.PP
Se você encontrar algum erro na tradução desta página de manual,
envie um e-mail para
.MT debian-l10n-portuguese@lists.debian.org
a lista de discussão de tradutores
.ME .