scanf_s, _scanf_s_l, wscanf_s_wscanf_s_l
표준 입력 스트림에서 형식이 지정된 데이터를 읽습니다. 이러한 버전의 < _scanf_l_wscanf_lwscanf a0/>에는 CRT의 scanf보안 기능에 설명된 대로 보안 기능이 향상되었습니다.
구문
int scanf_s(
const char *format [,
argument]...
);
int _scanf_s_l(
const char *format,
_locale_t locale [,
argument]...
);
int wscanf_s(
const wchar_t *format [,
argument]...
);
int _wscanf_s_l(
const wchar_t *format,
_locale_t locale [,
argument]...
);
매개 변수
format
형식 컨트롤 문자열입니다.
argument
선택적 인수입니다.
locale
사용할 로캘입니다.
반환 값
성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다. 반환 값은 오류에 대한 값이거나 EOF 첫 번째 문자 읽기 시도에서 파일 끝 문자 또는 문자열 끝 문자를 찾은 경우입니다. 포인터인 NULL 경우 format 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용한 경우 scanf_s 및 wscanf_s은 EOF를 반환하며 errno는 EINVAL로 설정됩니다.
이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno, _sys_errlist및_sys_nerr 를 참조하세요errno.
설명
함수는 scanf_s 표준 입력 스트림 stdin에서 데이터를 읽고 으로 씁니다 argument. 각각 argument 은 .의 형식 지정자에 format해당하는 변수 형식에 대한 포인터여야 합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.
wscanf_s 은 scanf_s의 와이드 문자 버전이며, format 에 대한 wscanf_s 인수는 와이드 문자열입니다. 스트림이 ANSI 모드에서 열리는 경우 wscanf_s 및 scanf_s가 동일하게 작동합니다. scanf_s는 현재 UNICODE 스트림에서의 입력을 지원하지 않습니다.
접미사가 있는 _l 이러한 함수의 버전은 현재 스레드 로캘 대신 매개 변수를 locale 사용한다는 점을 제외하고 동일합니다.
wscanfscanf_s wscanf_s 와 달리 scanf 일부 매개 변수에 대한 버퍼 크기를 지정해야 합니다. 모든c, , C, sS또는 문자열 컨트롤 집합 [] 매개 변수의 크기를 지정합니다. 문자의 버퍼 크기는 다른 매개 변수로 전달됩니다. 바로 버퍼 또는 변수에 대한 포인터를 따릅니다. 예를 들어 문자열을 읽는 경우 해당 문자열의 버퍼 크기는 다음과 같이 전달됩니다.
char s[10];
scanf_s("%9s", s, (unsigned)_countof(s)); // buffer size is 10, width specification is 9
버퍼 크기에는 터미널 null이 포함됩니다. 너비 사양 필드를 사용하여 읽은 토큰이 버퍼에 맞는지 확인할 수 있습니다. 토큰이 너무 커서 맞지 않는 경우 너비 사양이 없으면 버퍼에 기록되지 않습니다.
참고 항목
크기 매개 변수는 size_t가 아니라 unsigned 형식입니다. 64비트 빌드 구성에 대해 정적 캐스트를 사용하여 size_t 값을 unsigned로 변환합니다.
버퍼 크기 매개 변수는 바이트가 아닌 최대 문자 수를 설명합니다. 이 예제에서는 버퍼 형식의 너비가 서식 지정자의 너비와 일치하지 않습니다.
wchar_t ws[10];
wscanf_s(L"%9S", ws, (unsigned)_countof(ws));
S 형식 지정자는 함수에서 지원하는 기본 너비와 "반대"인 문자 너비를 사용한다는 것을 의미합니다. 문자 너비는 싱글 바이트이지만 함수는 더블 바이트 문자를 지원합니다. 이 예제에서는 최대 9개의 싱글 바이트 너비 문자 문자열을 읽고 더블 바이트 너비 문자 버퍼에 넣습니다. 문자는 싱글바이트 값으로 처리됩니다. 처음 두 문자는 ws[0]에 저장되고, 두 번째 두 문자는 ws[1]에 저장되는 방식입니다.
이 예제에서는 단일 문자를 읽습니다.
char c;
scanf_s("%c", &c, 1);
null로 종료되지 않은 문자열에 대해 여러 문자를 읽는 경우 너비 사양과 버퍼 크기 모두에 정수가 사용됩니다.
char c[4];
scanf_s("%4c", c, (unsigned)_countof(c)); // not null terminated
자세한 내용은 너비 사양을 참조 scanf 하세요.
일반 텍스트 루틴 매핑
TCHAR.H 루틴 |
_UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
|---|---|---|---|
_tscanf_s |
scanf_s |
scanf_s |
wscanf_s |
_tscanf_s_l |
_scanf_s_l |
_scanf_s_l |
_wscanf_s_l |
자세한 내용은 형식 사양 필드 scanf 및 wscanf 함수를 참조하세요.
요구 사항
| 루틴에서 반환된 값 | 필수 헤더 |
|---|---|
scanf_s, _scanf_s_l |
<stdio.h> |
wscanf_s, _wscanf_s_l |
<stdio.h> 또는 <wchar.h> |
UWP(유니버설 Windows 플랫폼) 앱에서는 콘솔이 지원되지 않습니다. 표준 스트림은 C 런타임 함수가 UWP 앱에서 사용할 수 있도록 하기 전에 이를 처리stdinstdout하고 stderr 리디렉션해야 합니다. 호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_scanf_s.c
// This program uses the scanf_s and wscanf_s functions
// to read formatted input.
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int i,
result;
float fp;
char c,
s[80];
wchar_t wc,
ws[80];
result = scanf_s( "%d %f %c %C %s %S", &i, &fp, &c, 1,
&wc, 1, s, (unsigned)_countof(s), ws, (unsigned)_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 = wscanf_s( L"%d %f %hc %lc %S %ls", &i, &fp, &c, 2,
&wc, 1, s, (unsigned)_countof(s), ws, (unsigned)_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
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