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

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

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

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

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

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

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

10진수 정수와 일치합니다.

• 숫자의 형식은 std::wcstol이 10 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다.

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

• 숫자의 형식은 std::wcstoul이 2 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다.

정수와 일치합니다.

• 숫자의 형식은 std::wcstol이 0 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다(기수는 구문 분석된 첫 번째 문자에 의해 결정됨).

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

• 숫자의 형식은 std::wcstoul이 10 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다.

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

• 숫자의 형식은 std::wcstoul이 8 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다.

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

• 숫자의 형식은 std::wcstoul이 16 base 인수에 대해 값 base을 사용하여 예상하는 형식과 동일합니다.

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

• 입력이 소비되지 않습니다. 할당 횟수를 증가시키지 않습니다.
• 지정자에 할당 억제 연산자가 정의되어 있으면 동작이 정의되지 않습니다.

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

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

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

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

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

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

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

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

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

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

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

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

변환 지정이 잘못된 경우 동작이 정의되지 않습니다.