vscanf
, vwscanf
표준 입력 스트림에서 형식이 지정된 데이터를 읽습니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. vscanf_s
, vwscanf_s
(을)를 참조하세요.
구문
int vscanf(
const char *format,
va_list arglist
);
int vwscanf(
const wchar_t *format,
va_list arglist
);
매개 변수
format
형식 컨트롤 문자열입니다.
arglist
가변 인수 목록입니다.
반환 값
성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다.
포인터인 NULL
경우 format
매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 EOF
를 반환하고 errno
를 EINVAL
로 설정합니다.
이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno
, _sys_errlist
및_sys_nerr
를 참조하세요errno
.
설명
vscanf
함수는 표준 입력 스트림 stdin
에서 데이터를 읽고 arglist
인수 목록에서 제공되는 위치에 해당 데이터를 씁니다. 목록의 각 인수는 format
의 형식 지정자에 해당되는 형식의 변수에 대한 포인터여야 합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.
Important
문자열을 읽는 데 사용하는 vscanf
경우 항상 %s 형식의 너비(예: "%s" 대신 "%32s")를 지정합니다. 그렇지 않으면 형식이 잘못 지정된 입력으로 인해 버퍼 오버런이 발생할 수 있습니다. 또는 를 사용할 vscanf_s
vwscanf_s
fgets
수 있습니다.
vwscanf
은 vscanf
의 와이드 문자 버전이며, format
에 대한 vwscanf
인수는 와이드 문자열입니다. 스트림이 ANSI 모드에서 열리는 경우 vwscanf
및 vscanf
가 동일하게 작동합니다. vscanf
는 UNICODE 스트림에서의 입력을 지원하지 않습니다.
일반 텍스트 루틴 매핑
TCHAR.H 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
---|---|---|---|
_vtscanf |
vscanf |
vscanf |
vwscanf |
자세한 내용은 형식 사양 필드 scanf
및 wscanf
함수를 참조하세요.
요구 사항
루틴에서 반환된 값 | 필수 헤더 |
---|---|
vscanf |
<stdio.h> |
vwscanf |
<stdio.h> 또는 <wchar.h> |
UWP(유니버설 Windows 플랫폼) 앱에서는 콘솔이 지원되지 않습니다. 콘솔에 연결된 표준 스트림 핸들, stdin
, stdout
및 stderr
은 UWP 앱의 C 런타임 함수에서 사용되기 전에 리디렉션되어야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_vscanf.c
// compile with: /W3
// This program uses the vscanf and vwscanf functions
// to read formatted input.
#include <stdio.h>
#include <stdarg.h>
int call_vscanf(char *format, ...)
{
int result;
va_list arglist;
va_start(arglist, format);
result = vscanf(format, arglist);
va_end(arglist);
return result;
}
int call_vwscanf(wchar_t *format, ...)
{
int result;
va_list arglist;
va_start(arglist, format);
result = vwscanf(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( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, 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( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, 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 charactersThe 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
fscanf
, _fscanf_l
, fwscanf
_fwscanf_l
printf
, _printf_l
, wprintf
_wprintf_l
sprintf
, _sprintf_l
, swprintf
, _swprintf_l
__swprintf_l
sscanf
, _sscanf_l
, swscanf
_swscanf_l
vscanf_s
, vwscanf_s