다음을 통해 공유

vscanf_s, vwscanf_s

  • 아티클

표준 입력 스트림에서 형식이 지정된 데이터를 읽습니다. 이러한 버전은 CRT의 vwscanfvscanf 보안 기능에 설명된 대로 향상된 보안 기능을 제공합니다.

구문

int vscanf_s(
   const char *format,
   va_list arglist
);
int vwscanf_s(
   const wchar_t *format,
   va_list arglist
);

매개 변수

format
형식 컨트롤 문자열입니다.

arglist
가변 인수 목록입니다.

반환 값

성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다. 오류가 발생했거나 문자를 읽는 첫 번째 시도에서 파일 끝 문자 또는 문자열 끝 문자가 발생한 경우 반환 값은 EOF입니다. 포인터인 NULL 경우 format 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용한 경우 vscanf_s 및 vwscanf_s은 EOF를 반환하며 errno는 EINVAL로 설정됩니다.

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

설명

vscanf_s 함수는 표준 입력 스트림 stdin에서 데이터를 읽고 arglist 인수 목록에서 제공되는 위치에 해당 데이터를 씁니다. 목록의 각 인수는 format의 형식 지정자에 해당되는 형식의 변수에 대한 포인터여야 합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

vwscanf_s 은 vscanf_s의 와이드 문자 버전이며, format 에 대한 vwscanf_s 인수는 와이드 문자열입니다. 스트림이 ANSI 모드에서 열리는 경우 vwscanf_s 및 vscanf_s가 동일하게 작동합니다. vscanf_s는 UNICODE 스트림에서의 입력을 지원하지 않습니다.

와 vscanf_s vwscanf_s vwscanf달리 vscanf []로 묶인 c, C, s, S 또는 문자열 컨트롤 집합의 모든 입력 매개 변수에 대해 버퍼 크기를 지정해야 합니다. 문자의 버퍼 크기는 버퍼 또는 변수에 대한 포인터 바로 다음에 다른 매개 변수로 전달됩니다. 문자열에 대한 wchar_t 문자의 버퍼 크기는 크기(바이트)와 다릅니다.

버퍼 크기에는 종료 null이 포함되어 있습니다. 너비 사양 필드를 사용하면 읽은 토큰이 버퍼에 맞는지 확인할 수 있습니다. 너비 사양 필드가 사용되지 않고 읽은 토큰이 너무 커서 버퍼에 맞지 않으면 해당 버퍼에 기록되지 않습니다.

참고 항목

size 매개 변수는 형식이 아니라 size_t형식unsigned입니다.

자세한 내용은 scanf 너비 사양을 참조하세요.

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE 및 _MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_vtscanf_s vscanf_s vscanf_s vwscanf_s

자세한 내용은 형식 사양 필드 scanf 및 wscanf 함수를 참조하세요.

요구 사항

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

UWP(유니버설 Windows 플랫폼) 앱에서는 콘솔이 지원되지 않습니다. 콘솔에 연결된 표준 스트림 핸들, stdin, stdout 및 stderr은 UWP 앱의 C 런타임 함수에서 사용되기 전에 리디렉션되어야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_vscanf_s.c
// compile with: /W3
// This program uses the vscanf_s and vwscanf_s functions
// to read formatted input.

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

int call_vscanf_s(char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vscanf_s(format, arglist);
    va_end(arglist);
    return result;
}

int call_vwscanf_s(wchar_t *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vwscanf_s(format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    int   i, result;
    float fp;
    char  c, s[81];
    wchar_t wc, ws[81];
    result = call_vscanf_s("%d %f %c %C %s %S", &i, &fp, &c, 1,
                           &wc, 1, s, _countof(s), ws, _countof(ws) );
    printf( "The number of fields input is %d\n", result );
    printf( "The contents are: %d %f %c %C %s %S\n", i, fp, c, wc, s, ws);
    result = call_vwscanf_s(L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
                            &wc, 1, s, _countof(s), ws, _countof(ws) );
    wprintf( L"The number of fields input is %d\n", result );
    wprintf( L"The contents are: %d %f %C %c %hs %s\n", i, fp, c, wc, s, ws);
}

이 프로그램에 예제의 입력을 제공하면 다음과 같은 출력이 생성됩니다.

71 98.6 h z Byte characters
36 92.3 y n Wide characters

The number of fields input is 6
The contents are: 71 98.599998 h z Byte characters
The number of fields input is 6
The contents are: 36 92.300003 y n Wide characters

참고 항목

수학 및 부동 소수점 지원
스트림 I/O
Locale
printf, _printf_l, wprintf_wprintf_l
scanf, _scanf_l, wscanf_wscanf_l
scanf_s, _scanf_s_l, wscanf_s_wscanf_s_l
vscanf, vwscanf