wcstok, wcstok_s

• 만약 str ! = NULL 이면, 이 호출은 해당 와이드 문자열에 대한 첫 번째 wcstok 호출로 처리됩니다. 함수는 delim 에 포함되지 않는 첫 번째 와이드 문자를 검색합니다.

• 해당하는 와이드 문자가 발견되지 않으면, str 내에 토큰이 전혀 존재하지 않는 것이며, 함수는 널 포인터를 반환합니다.
• 해당하는 와이드 문자가 발견되면, 이것이 토큰의 시작점 입니다. 함수는 그 지점부터 delim 에 포함 되는 첫 번째 와이드 문자를 검색합니다.

• 해당하는 와이드 문자가 발견되지 않으면, str 에는 단 하나의 토큰만 존재하며, 이후 wcstok 호출은 널 포인터를 반환합니다.
• 해당하는 와이드 문자가 발견되면, 그것은 널 와이드 문자 L ' \0 ' 로 대체 되며, 파서 상태(일반적으로 다음 와이드 문자를 가리키는 포인터)는 사용자가 제공한 위치 * ptr 에 저장됩니다.

• 그런 다음 함수는 토큰의 시작점을 가리키는 포인터를 반환합니다.

• 만약 str == NULL 이면, 이 호출은 wcstok 의 후속 호출로 처리됩니다: 함수는 동일한 * ptr 을 사용하여 이전 호출에서 중단된 지점부터 계속 진행합니다. 이 동작은 마지막으로 발견된 토큰 다음에 오는 와이드 문자를 가리키는 포인터가 str 으로 전달된 경우와 동일합니다.

매개변수

반환값

다음 토큰의 시작 부분에 대한 포인터를 반환하거나, 더 이상 토큰이 없을 경우 null 포인터를 반환합니다.

참고

이 함수는 파괴적입니다: 문자열 str 의 요소들에 L ' \0 ' 문자들을 기록합니다. 특히, 와이드 문자열 리터럴은 wcstok 의 첫 번째 인수로 사용될 수 없습니다.

strtok 과 달리, wcstok 는 정적 저장소를 갱신하지 않습니다: 파서 상태를 사용자가 제공한 위치에 저장합니다.

대부분의 다른 토크나이저와 달리, wcstok 에서는 각 후속 토큰에 대한 구분자가 다를 수 있으며, 이전 토큰의 내용에 따라 달라질 수도 있습니다.

wcstok_s 의 구현은 Windows CRT 에서 C 표준과 호환되지 않으며, 이는 단순히 wcstok 의 별칭일 뿐입니다.

예제

#include <stdio.h>
#include <wchar.h>
int main(void)
{
    wchar_t input[] = L"A bird came down the walk";
    printf("Parsing the input string '%ls'\n", input);
    wchar_t* buffer;
    wchar_t* token = wcstok(input, L" ", &buffer);
    while (token)
    {
        printf("%ls\n", token);
        token = wcstok(NULL, L" ", &buffer);
    }
    printf("Contents of the input string now: '");
    for (size_t n = 0; n < sizeof input / sizeof *input; ++n)
        input[n] ? printf("%lc", input[n]) : printf("\\0");
    puts("'");
}

Parsing the input string 'A bird came down the walk'
A
bird
came
down
the
walk
Contents of the input string now: 'A\0bird\0came\0down\0the\0walk\0'

참고문헌

참고 항목