wcstok(3) Library Functions Manual wcstok(3) NOME wcstok - separa uma string de caracteres largos em tokens BIBLIOTECA Biblioteca C Padrao (libc, -lc) SINOPSE #include wchar_t *wcstok(wchar_t *restrict wcs, const wchar_t *restrict delim, wchar_t **restrict ptr); DESCRICAO A funcao wcstok() e o equivalente de caracteres largos da funcao strtok(), com um argumento adicional para torna-la segura para multithread. Ela pode ser usada para separar uma string de caracteres largos wcs em tokens, onde um token e definido como uma substring que nao contem nenhum dos caracteres largos de delim. A busca inicia em wcs, se wcs nao e NULO, ou em *ptr, se wcs e NULO. Primeiramente, quaisquer caracteres largos delimitadores sao pulados, ou seja, o ponteiro e avancado para alem de quaisquer caracteres largos que ocorrem em delim. Se o fim da string de caracteres largos e alcancado neste momento, wcstok() retorna NULO, para indicar que nenhum token foi encontrado, e guarda um valor apropriado em *ptr, de forma que chamadas subsequentes a wcstok() continuarao retornando NULO. Caso contrario, a funcao wcstok() reconhece o inicio de um token e retorna um ponteiro para ele, mas antes de faze-lo, ela termina com zero o token, substituindo o proximo caractere largo que ocorre em delim com um caractere (L'\0'), e ela atualiza *ptr de forma que as chamadas subsequentes continuarao a busca depois do fim do token reconhecido. VALOR DE RETORNO A funcao wcstok() retorna um ponteiro para o proximo token, ou NULO se nenhum token adicional foi encontrado. ATRIBUTOS Para uma explicacao dos termos usados nesta secao, consulte attributes(7). +--------------------------------------------+---------------+---------+ |Interface | Atributo | Valor | +--------------------------------------------+---------------+---------+ |wcstok() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ PADROES C11, POSIX.1-2008. HISTORICO POSIX.1-2001, C99. NOTAS A string de caracteres largos original wcs e modificada destrutivamente durante a operacao. EXEMPLOS O seguinte codigo percorre os tokens contidos numa string de caracteres largos. 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)) { ... } VEJA TAMBEM strtok(3), wcschr(3) TRADUCAO A traducao para portugues brasileiro desta pagina man foi criada por Felipe M Pereira , Andre Luiz Fassone e Rafael Fontenelle . Esta traducao e uma documentacao livre; leia a Licenca Publica Geral GNU Versao 3 ou posterior para as condicoes de direitos autorais. Nenhuma responsabilidade e aceita. Se voce encontrar algum erro na traducao desta pagina de manual, envie um e-mail para a lista de discussao de tradutores . Linux man-pages 6.18 8 fevereiro 2026 wcstok(3)