scanf, _scanf_l, wscanf, _wscanf_l

표준 입력 스트림에서 형식이 지정된 데이터를 읽습니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 참조 scanf_s, _scanf_s_l, wscanf_s_wscanf_s_l.

참고 항목

Visual Studio 2015 printf 에서 함수 및 scanf 제품군이 선언 inline 되고 헤더로 <conio.h> 이동 <stdio.h> 되었습니다. 이전 코드를 마이그레이션하는 경우 이러한 함수와 관련하여 링커 오류 LNK2019 표시될 수 있습니다. 자세한 내용은 Visual C++ 변경 기록 2003 - 2015를 참조하세요.

구문

int scanf(
   const char *format [,
   argument]...
);
int _scanf_l(
   const char *format,
   _locale_t locale [,
   argument]...
);
int wscanf(
   const wchar_t *format [,
   argument]...
);
int _wscanf_l(
   const wchar_t *format,
   _locale_t locale [,
   argument]...
);

매개 변수

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

argument
선택적 인수입니다.

locale
사용할 로캘입니다.

반환 값

성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다.

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

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

설명

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

Important

scanf를 사용하여 문자열을 읽을 때는 항상 %s 형식의 너비를 지정합니다. 예를 들어 %s 대신 %32s를 지정해야 합니다. 그렇지 않으면 서식이 잘못된 입력으로 인해 버퍼 오버런이 발생하기 쉽습니다. 또는 , _scanf_s_l또는 wscanf_sfgets_wscanf_s_l .를 사용하는 scanf_s것이 좋습니다.

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

_l 접미사가 있는 이러한 함수 버전은 현재 스레드 로캘 대신 전달된 로캘 매개 변수를 사용하는 경우를 제외하고는 동일합니다.

일반 텍스트 루틴 매핑

TCHAR.H 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tscanf	scanf	scanf	wscanf
_tscanf_l	_scanf_l	_scanf_l	_wscanf_l

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

요구 사항

루틴에서 반환된 값	필수 헤더
scanf, _scanf_l	<stdio.h>
wscanf, _wscanf_l	<stdio.h> 또는 <wchar.h>

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

예시

// crt_scanf.c
// compile with: /W3
// This program uses the scanf and wscanf functions
// to read formatted input.

#include <stdio.h>

int main( void )
{
   int   i, result;
   float fp;
   char  c, s[81];
   wchar_t wc, ws[81];
   result = scanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, ws ); // C4996
   // Note: scanf and wscanf are deprecated; consider using scanf_s and wscanf_s
   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( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, ws ); // C4996
   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