std:: wscanf, std:: fwscanf, std:: swscanf

문자 또는 문자 시퀀스 와 매칭됩니다.

• 너비 지정자가 사용된 경우, 정확히 width 개의 와이드 문자와 매칭됩니다 (인자는 충분한 공간을 가진 배열에 대한 포인터여야 합니다).
• %s 및 %[와 달리 배열에 널 문자를 추가하지 않습니다.

공백 문자가 아닌 문자들의 시퀀스( 문자열 )와 매칭됩니다.

• 너비 지정자가 사용된 경우, width 까지 또는 첫 번째 공백 문자 중 먼저 나타나는 것까지 매칭됩니다.
• 항상 매칭된 문자들에 추가로 널 문자를 저장합니다 (따라서 인자 배열은 최소 width+1 개의 문자를 수용할 수 있는 공간이 있어야 합니다).

set 에 포함된 문자들로 이루어진 비어 있지 않은 문자 시퀀스와 매치됩니다.

• 집합의 첫 번째 문자가 ^ 인 경우, 집합에 포함되지 않은 모든 문자가 매치됩니다.
• 집합이 ] 또는 ^] 로 시작하는 경우, ] 문자도 집합에 포함됩니다.
• 스캔 집합 내에서 처음 위치가 아닌 곳에 있는 - 문자가 [0-9] 와 같이 범위를 나타낼 수 있는지는 구현에 따라 정의됩니다.
• 너비 지정자가 사용된 경우, 최대 width 까지만 매치됩니다.
• 매치된 문자들에 추가로 항상 null 문자를 저장합니다 (따라서 인수 배열은 최소 width+1 개의 문자를 수용할 수 있는 공간이 있어야 합니다).

10진수 정수 와 매칭됩니다.

• 숫자의 형식은 std::wcstol 함수에서 10 을 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이거나 위에서 명시된 대로 변환할 수 없는 경우, 스트림에서의 입력이 파일 끝(end-of-file), 인코딩 오류 또는 읽기 오류로 인해 방해받지 않는 한 매칭 실패가 발생합니다. 이러한 경우에는 입력 실패로 간주됩니다.

[ , c , n 을 제외한 모든 변환 지정자는 입력 파싱을 시도하기 전에 모든 선행 공백 문자( std::iswspace 를 호출하는 것처럼 결정됨)를 소비하고 버립니다. 이렇게 소비된 문자는 지정된 최대 필드 너비에 포함되지 않습니다.

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

변환 지정자 s 와 [ 는 항상 매칭된 문자에 더해 널 종결 문자(null terminator)를 저장합니다. 대상 배열의 크기는 지정된 필드 너비보다 최소한 하나 이상 커야 합니다. % s 또는 % [ 를 사용하면서 대상 배열 크기를 지정하지 않는 것은 std::gets 와 마찬가지로 안전하지 않습니다.

고정 너비 정수 타입 ( std::int8_t 등)에 대한 올바른 변환 지정자는 헤더 <cinttypes> 에 정의되어 있습니다(비록 SCNdMAX , SCNuMAX 등이 % jd , % ju 등과 동의어이지만).

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

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

변환 명세가 유효하지 않은 경우, 동작은 정의되지 않습니다.