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_swscanf_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