vsscanf, vswscanf

문자열에서 형식이 지정된 데이터를 읽습니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 를 참조하세요vsscanf_s. vswscanf_s

구문

int vsscanf(
   const char *buffer,
   const char *format,
   va_list arglist
);
int vswscanf(
   const wchar_t *buffer,
   const wchar_t *format,
   va_list arglist
);

매개 변수

buffer
저장된 데이터

format
형식 컨트롤 문자열입니다. 자세한 내용은 형식 사양 필드 scanf 및 wscanf 함수를 참조하세요.

arglist
가변 인수 목록입니다.

반환 값

이러한 각 함수는 성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다. 오류가 발생하거나 첫 번째 변환 전에 문자열의 끝에 도달할 경우 반환 값은 EOF입니다.

포인터이거나 format 포인터인 NULL 경우 buffer 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우 이러한 함수가 -1을 반환하고 errno 를 EINVAL로 설정합니다.

이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno, _sys_errlist및_sys_nerr 를 참조하세요errno.

설명

vsscanf 함수는 arglist 인수 목록의 각 인수가 제공하는 위치로 buffer의 데이터를 읽습니다. 목록의 모든 인수는 format의 형식 지정자에 해당되는 형식의 변수에 대한 포인터여야 합니다. format 인수는 입력 필드의 해석을 제어하며, 형식과 기능은 scanf 함수의 format 인수와 동일합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

Important

문자열을 읽는 데 사용하는 vsscanf 경우 항상 %s 형식의 너비(예: "%s" 대신 "%32s")를 지정합니다. 그렇지 않으면 형식이 잘못 지정된 입력으로 인해 버퍼 오버런이 발생할 수 있습니다.

vswscanf 는 vsscanf의 와이드 문자 버전이며, vswscanf 에 대한 인수는 와이드 문자 문자열입니다. vsscanf 는 멀티바이트 16진수 문자를 처리하지 않습니다. vswscanf 는 유니코드 전폭 16진수 또는 "호환성 영역" 문자를 처리하지 않습니다. 그렇지 않으면 vswscanf 과 vsscanf 은 동일하게 작동합니다.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_vstscanf	vsscanf	vsscanf	vswscanf

요구 사항

루틴에서 반환된 값	필수 헤더
vsscanf	<stdio.h>
vswscanf	<stdio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_vsscanf.c
// compile with: /W3
// This program uses vsscanf to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>
#include <stdarg.h>

int call_vsscanf(char *tokenstring, char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vsscanf(tokenstring, format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    char  tokenstring[] = "15 12 14...";
    char  s[81];
    char  c;
    int   i;
    float fp;

    // Input various data from tokenstring:
    // max 80 character string:
    call_vsscanf(tokenstring, "%80s", s);
    call_vsscanf(tokenstring, "%c", &c);
    call_vsscanf(tokenstring, "%d", &i);
    call_vsscanf(tokenstring, "%f", &fp);

    // Output the data read
    printf("String    = %s\n", s);
    printf("Character = %c\n", c);
    printf("Integer:  = %d\n", i);
    printf("Real:     = %f\n", fp);
}

String    = 15
Character = 1
Integer:  = 15
Real:     = 15.000000

참고 항목

스트림 I/O
scanf, _scanf_l, wscanf, _wscanf_l
sscanf, _sscanf_l, swscanf, _swscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vsscanf_s, vswscanf_s