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. The search starts at wcs, if wcs is not NULL, or at *ptr, if wcs is NULL. First, any delimiter wide-characters are skipped, that is, the pointer is advanced beyond any wide-characters which occur in delim. 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 to wcstok() will continue to return NULL. Otherwise, the wcstok() 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 delim with a null wide character (L'\0'), and it updates *ptr so that subsequent calls will continue searching after the end of recognized token. 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.06 31 outubro 2023 wcstok(3)