sscanf, _sscanf_l, swscanf, _swscanf_l

문자열에서 형식이 지정된 데이터를 읽습니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 참조 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입니다.

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

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

설명

sscanf 함수는 각 argument에서 제공하는 위치로 buffer의 데이터를 읽습니다. 각 argument는 format의 형식 지정자에 해당되는 형식의 변수에 대한 포인터여야 합니다. format 인수는 입력 필드의 해석을 제어하며, 형식과 기능은 scanf 함수의 format 인수와 동일합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

scanf 형식 필드 문자에 대한 자세한 내용은 형식 필드 문자를 참조 scanf 하세요. scanf 형식 사양 필드에 대한 자세한 내용은 형식 사양 필드를 참조 하세요.

Important

문자열sscanf을 읽을 때 항상 형식의 너비%s(예: ""가 아닌 "%32s%s")를 지정합니다. 그렇지 않으면 형식이 잘못 지정된 입력으로 인해 버퍼 오버런이 쉽게 발생할 수 있습니다.

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 );
}

String    = 15
Character = 1
Integer:  = 15
Real:     = 15.000000

참고 항목

스트림 I/O
fscanf, _fscanf_l, fwscanf, _fwscanf_l
scanf, _scanf_l, wscanf, _wscanf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
snprintf, _snprintf, _snprintf_l, _snwprintf, _snwprintf_l