std:: vwscanf, std:: vfwscanf, std:: vswscanf

문자 또는 문자 시퀀스와 일치합니다.

• 폭 지정자가 사용되면 정확히 width 와이드 문자와 일치합니다 (인자는 충분한 공간이 있는 배열에 대한 포인터여야 합니다).
• %s 및  %[와 달리 배열에 널 문자를 추가하지 않습니다.

공백이 아닌 문자 시퀀스 (문자열)와 일치합니다.

• 폭 지정자가 사용되면 최대 width까지 또는 첫 번째 공백 문자까지, 둘 중 먼저 나타나는 것까지 일치합니다.
• 일치한 문자 외에도 항상 널 문자를 저장합니다 (따라서 인자 배열은 적어도 width+1 문자를 위한 공간이 있어야 합니다).

문자 집합에서 비어 있지 않은 문자 시퀀스와 일치합니다.

• 집합의 첫 번째 문자가 ^이면 집합에 없는 모든 문자가 일치됩니다.
• 집합이 ] 또는 ^]로 시작하면 ] 문자도 집합에 포함됩니다.
• 스캔셋의 초기 위치가 아닌 위치에 있는 문자 -가 [0-9]에서와 같이 범위를 나타내는지 여부는 구현에 따라 정의됩니다.
• 폭 지정자가 사용되면 최대 width까지만 일치합니다.
• 일치한 문자 외에도 항상 널 문자를 저장합니다 (따라서 인자 배열은 적어도 width+1 문자를 위한 공간이 있어야 합니다).

10진 정수와 일치합니다.

• 숫자의 형식은 std::wcstol에서 10 인수 값이 base일 때 예상하는 형식과 동일합니다.

부호 없는 2진 정수와 일치합니다.

• 숫자의 형식은 std::wcstoul에서 2 인수 값이 base일 때 예상하는 형식과 동일합니다.

정수와 일치합니다.

• 숫자의 형식은 std::wcstol에서 0 인수 값이 base일 때 예상하는 형식과 동일합니다 (진법은 구문 분석된 첫 번째 문자에 의해 결정됩니다).

부호 없는 10진 정수와 일치합니다.

• 숫자의 형식은 std::wcstoul에서 10 인수 값이 base일 때 예상하는 형식과 동일합니다.

부호 없는 8진 정수와 일치합니다.

• 숫자의 형식은 std::wcstoul에서 8 인수 값이 base일 때 예상하는 형식과 동일합니다.

부호 없는 16진 정수와 일치합니다.

• 숫자의 형식은 std::wcstoul에서 16 인수 값이 base일 때 예상하는 형식과 동일합니다.

지금까지 읽은 문자 수를 반환합니다.

• 입력을 소비하지 않습니다. 할당 횟수를 증가시키지 않습니다.
• 지정자에 할당 억제 연산자가 정의된 경우 동작은 정의되지 않습니다.

부동 소수점 숫자와 일치합니다.

• 숫자의 형식은 std::wcstof에서 예상하는 형식과 동일합니다.

포인터를 정의하는 구현 정의 문자 시퀀스와 일치합니다.

• printf 계열 함수는 %p 형식 지정자를 사용하여 동일한 시퀀스를 생성해야 합니다.

n이외의 모든 변환 지정자에 대해, 지정된 필드 폭을 초과하지 않으면서 변환 지정자가 정확히 기대하는 것과 일치하거나 기대하는 시퀀스의 접두사인 가장 긴 입력 문자 시퀀스가 스트림에서 소비됩니다. 이 소비된 시퀀스 이후의 첫 번째 문자(있는 경우)는 읽히지 않은 상태로 남습니다. 소비된 시퀀스의 길이가 0이거나 소비된 시퀀스를 위에 지정된 대로 변환할 수 없는 경우, 스트림에서 입력을 방해하는 파일 끝, 인코딩 오류 또는 읽기 오류가 없는 한 일치 실패가 발생하며, 그렇지 않으면 입력 실패입니다.

% 지정자를 제외하고, 입력 항목(또는 %n의 경우 입력 문자 수)은 먼저 변환 지정자에 적합한 유형으로 변환됩니다. *로 할당이 억제되지 않은 경우, 변환 결과는 아직 쓰여지지 않은 다음 인자가 가리키는 객체에 기록됩니다. 이 객체가 적절한 유형이 아니거나 변환 결과를 객체에 표현할 수 없는 경우 동작은 정의되지 않습니다.

[, c 및 n 이외의 모든 변환 지정자는 입력 구문 분석을 시도하기 전에 모든 선행 공백 문자(마치 std::iswspace를 호출하여 결정된 것처럼)를 소비하고 버립니다. 이러한 소비된 문자는 지정된 최대 필드 폭에 포함되지 않습니다.

길이 지정자 l를 사용하지 않는 경우, 변환 지정자 c, s 및 [는 첫 번째 문자가 변환되기 전에 0으로 초기화된 std::mbstate_t 객체를 사용하여 std::wcrtomb를 호출하는 것처럼 와이드-멀티바이트 문자 변환을 수행합니다.

변환 지정자 s와 [은 항상 일치된 문자 외에도 널 종결자를 저장합니다. 대상 배열의 크기는 지정된 필드 폭보다 적어도 1이 더 커야 합니다. 대상 배열 크기를 지정하지 않고 %s 또는 %[를 사용하는 것은 std::gets만큼 안전하지 않습니다.

고정 폭 정수 유형 (std::int8_t 등)에 대한 올바른 변환 지정은 헤더 <cinttypes>에 정의되어 있습니다 (SCNdMAX, SCNuMAX 등은 %jd, %ju 등과 동의어입니다).

각 변환 지정자의 동작 후에 시퀀스 포인트가 있습니다. 이는 동일한 "싱크" 변수에 여러 필드를 저장할 수 있게 합니다.

변환 지정자 "100er"로 %f을 구문 분석할 때와 같이 지수가 있고 숫자가 없는 불완전한 부동 소수점 값을 구문 분석할 때, 시퀀스 "100e" (가능한 유효한 부동 소수점 숫자의 가장 긴 접두사)가 소비되어 일치 오류가 발생하고 (소비된 시퀀스를 부동 소수점 숫자로 변환할 수 없음) "r"이 남습니다. 일부 기존 구현은 이 규칙을 따르지 않고 "100"만 소비하도록 롤백하여 "er"을 남겨둡니다. 예: glibc 버그 1765.

변환 지정이 유효하지 않으면 동작은 정의되지 않습니다.