sscanf, _sscanf_l, swscanf, _swscanf_l

아티클
06/09/2015

문자열에서 형식 데이터를 읽습니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l를 참조하십시오.

int sscanf(
   const char *buffer,
   const char *format [,
   argument ] ... 
);
int _sscanf_l(
   const char *buffer,
   const char *format,
   locale_t locale [,
   argument ] ... 
);
int swscanf(
   const wchar_t *buffer,
   const wchar_t *format [,
   argument ] ... 
);
int _swscanf_l(
   const wchar_t *buffer,
   const wchar_t *format,
   locale_t locale [,
   argument ] ... 
);

매개 변수

buffer
저장된 데이터
format
형식 컨트롤 문자열입니다. 자세한 내용은 형식 사양을 참조하십시오.
argument
선택적 인수
locale
사용할 로캘입니다.

반환 값

이들 함수는 각각 성공적으로 변환, 배정된 필드 수를 반환합니다. 이때 읽기는 되었지만 지정되지 않은 필드는 반환 값에 포함되지 않습니다. 반환 값 0은 어떤 필드도 할당되지 않았음을 나타냅니다. 오류가 발생하거나 첫 번째 변환 전에 문자열의 끝에 도달할 경우 반환 값은 EOF입니다.

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

이러한 오류 코드 및 기타 오류 코드에 대한 내용은 _doserrno, errno, _sys_errlist 및 _sys_nerr을 참조하십시오.

설명

sscanf 함수는 각 argument로 부터 주어진 로캘의 buffer 로 부터 데이터를 읽습니다. 목록의 모든 argument 는 format 에서 형식 지정자와 일치하는 특정 형식의 변수에 대한 포인터가 되어야 합니다. format 인수는 입력 필드의 해석을 제어하고 scanf 함수의 format 인수와 동일한 폼과 함수를 가집니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

보안 정보
sscanf를 사용하여 문자열을 읽을 경우 %s 서식의 너비(예: "%s" 대신 "%32s" )를 항상 지정해야 합니다. 그렇지 않으면 서식이 적절하지 않게 지정된 입력으로 쉽게 버퍼 오버런이 발생할 수 있습니다.

swscanf는 sscanf의 와이드 문자 버전이며, swscanf에 대한 인수는 와이드 문자 문자열입니다. sscanf는 멀티 바이트 16진수 문자를 처리하지 않습니다. swscanf 는 "호환성 영역" 문자들 또는 유니코드 최대 넓이의 16진수를 처리하지 않습니다. 그렇지 않으면 swscanf과 sscanf은 동일하게 작동합니다.

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

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE &및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_stscanf	sscanf	sscanf	swscanf
_stscanf_l	_sscanf_l	_sscanf_l	_swscanf_l

요구 사항

루틴	필수 헤더
sscanf, _sscanf_l	<stdio.h>
swscanf, _swscanf_l	<stdio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.

예제

// crt_sscanf.c
// compile with: /W3
// This program uses sscanf to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>

int main( void )
{
   char  tokenstring[] = "15 12 14...";
   char  s[81];
   char  c;
   int   i;
   float fp;

   // Input various data from tokenstring:
   // max 80 character string:
   sscanf( tokenstring, "%80s", s ); // C4996
   sscanf( tokenstring, "%c", &c );  // C4996
   sscanf( tokenstring, "%d", &i );  // C4996
   sscanf( tokenstring, "%f", &fp ); // C4996
   // Note: sscanf is deprecated; consider using sscanf_s instead

   // Output the data read
   printf( "String    = %s\n", s );
   printf( "Character = %c\n", c );
   printf( "Integer:  = %d\n", i );
   printf( "Real:     = %f\n", fp );
}