Namespaces
Variants

std:: vscanf, std:: vfscanf, std:: vsscanf

From ko.cppreference.net
< cpp ‎ | io ‎ | c
헤더 파일에 정의됨 <cstdio>
int vscanf ( const char * format, std :: va_list vlist ) ;
(1) (C++11 이후)
int vfscanf ( std:: FILE * stream, const char * format, std :: va_list vlist ) ;
(2) (C++11 이후)
int vsscanf ( const char * buffer, const char * format, std :: va_list vlist ) ;
(3) (C++11 이후)

다양한 소스로부터 데이터를 읽어서 format 에 따라 해석하고, 결과를 vlist 로 정의된 위치에 저장합니다.

1) 데이터를 stdin 에서 읽어옵니다.
2) 파일 스트림 stream 에서 데이터를 읽습니다.
3) 널 종료 문자열에서 데이터를 읽습니다 buffer .

목차

매개변수

stream - 읽을 입력 파일 스트림
buffer - 읽을 널 종료 문자 문자열을 가리키는 포인터
format - 입력을 읽는 방법을 지정하는 널 종료 문자 문자열을 가리키는 포인터
vlist - 수신 인자를 담은 가변 인자 목록.


format 문자열은 다음으로 구성됩니다:

  • %이 아닌 공백이 아닌 멀티바이트 문자: 형식 문자열의 각 문자는 입력 스트림에서 정확히 하나의 동일한 문자를 소비하거나, 스트림의 다음 문자가 같지 않으면 함수가 실패합니다.
  • 공백 문자: 형식 문자열의 단일 공백 문자는 입력에서 사용 가능한 모든 연속된 공백 문자를 소비합니다(마치 루프에서 std::isspace를 호출하는 것처럼 결정됨). 형식 문자열에서 "\n", " ", "\t\t" 또는 기타 공백 사이에는 차이가 없습니다.
  • 변환 지정. 각 변환 지정은 다음 형식을 가집니다:
  • 도입 문자 %.
  • (선택 사항) 할당 억제 문자 *. 이 옵션이 있으면 함수는 변환 결과를 수신 인자에 할당하지 않습니다.
  • (선택 사항) 최대 필드 너비를 지정하는 0보다 큰 정수. 즉, 현재 변환 지정에 의해 지정된 변환을 수행할 때 함수가 소비할 수 있는 최대 문자 수입니다. 너비가 제공되지 않으면 %s 및 %[가 버퍼 오버플로를 일으킬 수 있습니다.
  • (선택 사항) 길이 수식자로, 수신 인자의 크기, 즉 실제 대상 유형을 지정합니다. 이는 변환 정확도와 오버플로 규칙에 영향을 줍니다. 기본 대상 유형은 각 변환 유형에 따라 다릅니다(아래 표 참조).
  • 변환 형식 지정자.

사용 가능한 형식 지정자는 다음과 같습니다:

변환
지정자
설명 예상
인자 유형
길이 수식자→ hh h 없음 l ll j z t L
C++11부터만 사용 가능→ 예 예 예 예 예
%
리터럴 %과 일치합니다.
해당 없음 해당 없음 해당 없음 해당 없음 해당 없음 해당 없음 해당 없음 해당 없음 해당 없음
c

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

  • 너비 지정자가 사용되면 정확히 너비 문자와 일치합니다(인자는 충분한 공간이 있는 배열을 가리키는 포인터여야 합니다).
  • %s 및  %[와 달리 배열에 널 문자를 추가하지 않습니다.
해당 없음 해당 없음
char*
wchar_t*
해당 없음 해당 없음 해당 없음 해당 없음 해당 없음
s

공백이 아닌 문자 시퀀스(문자열)와 일치합니다. 너비 지정자가 사용되면

  • 너비까지 또는 첫 번째 공백 문자까지 중 먼저 나타나는 것까지 일치합니다.일치된 문자 외에 항상 널 문자를 저장합니다(따라서 인자 배열은 최소한
  • 너비+1 문자를 위한 공간이 있어야 합니다).집합
[ ]

문자 집합의 비어 있지 않은 시퀀스와 일치합니다. 집합의 첫 문자가

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

십진 정수와 일치합니다.

  • 숫자의 형식은 std::strtol에서 10 인수에 대해 값 base을 사용하여 예상하는 것과 같습니다.
signed char* 또는 unsigned char*
signed short* 또는 unsigned short*
signed int* 또는 unsigned int*
signed long* 또는 unsigned long*
signed long long* 또는 unsigned long long*
std::intmax_t* 또는 std::uintmax_t*
std::size_t*
std::ptrdiff_t*
해당 없음
b (C++26)

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

  • 숫자의 형식은 std::strtoul에서 2 인수에 대해 값 base을 사용하여 예상하는 것과 같습니다.
i

정수

  • 와 일치합니다. 숫자의 형식은 std::strtol0에서 base 인수에 대해 값
u

을 사용하여 예상하는 것과 같습니다(진수는 구문 분석된 첫 번째 문자에 의해 결정됨).부호 없는 십진 정수

  • 와 일치합니다. 숫자의 형식은 std::strtoul10에서 base 인수에 대해 값
o

을 사용하여 예상하는 것과 같습니다.부호 없는 팔진 정수

  • 와 일치합니다. 숫자의 형식은 std::strtoul8에서 base 인수에 대해 값
x
X

을 사용하여 예상하는 것과 같습니다.부호 없는 십육진 정수

  • 와 일치합니다. 숫자의 형식은 std::strtoul16에서 base 인수에 대해 값
n

을 사용하여 예상하는 것과 같습니다.지금까지 읽은 문자 수

  • 를 반환합니다.
  • 입력이 소비되지 않습니다. 할당 카운트를 증가시키지 않습니다.
a 지정자에 할당 억제 연산자가 정의되어 있으면 동작은 정의되지 않습니다.
A (C++11)
e
E
f
F (C++11)
g
G

부동 소수점 숫자

  • 와 일치합니다. 숫자의 형식은 std::strtof
에서 예상하는 것과 같습니다. 해당 없음
float*
double*
해당 없음 해당 없음 해당 없음 해당 없음
long double*
p

포인터

  • printf를 정의하는 구현 정의 문자 시퀀스와 일치합니다. %p 함수 계열은
형식 지정자를 사용하여 동일한 시퀀스를 생성해야 합니다. 해당 없음
void**
해당 없음 해당 없음 해당 없음 해당 없음 해당 없음 해당 없음
참고

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

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

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

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

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

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

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

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

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

반환값

성공적으로 읽은 인수의 개수, 또는 EOF 가 실패 시 발생하는 경우.

참고 사항

이 모든 함수들은 최소한 한 번 이상 va_arg 를 호출하며, 반환 후 arg 의 값은 정의되지 않습니다. 이 함수들은 va_end 를 호출하지 않으며, 호출자가 이를 수행해야 합니다.

예제

#include <cstdarg>
#include <cstdio>
#include <iostream>
#include <stdexcept>
void checked_sscanf(int count, const char* buf, const char *fmt, ...)
{
    std::va_list ap;
    va_start(ap, fmt);
    if (std::vsscanf(buf, fmt, ap) != count)
        throw std::runtime_error("parsing error");
    va_end(ap);
}
int main()
{
    try
    {
        int n, m;
        std::cout << "Parsing '1 2'... ";
        checked_sscanf(2, "1 2", "%d %d", &n, &m);
        std::cout << "success\n";
        std::cout << "Parsing '1 a'... ";
        checked_sscanf(2, "1 a", "%d %d", &n, &m);
        std::cout << "success\n";
    }
    catch (const std::exception& e)
    {
        std::cout << e.what() << '\n';
    }
}

출력:

Parsing '1 2'... success
Parsing '1 a'... parsing error

참고 항목

stdin , 파일 스트림 또는 버퍼에서 형식화된 입력을 읽음
(함수)
가변 인수 목록을 사용하여 stdout , 파일 스트림 또는 버퍼에 형식화된 출력을 인쇄
(함수)
C 문서 for vscanf , vfscanf , vsscanf