sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

  • 아티클

문자열에서 형식이 지정된 데이터를 읽습니다. 이러한 버전의 < _sscanf_l_swscanf_lswscanf a0/>에는 CRT의 sscanf보안 기능에 설명된 대로 보안 기능이 향상되었습니다.

구문

int sscanf_s(
   const char *buffer,
   const char *format [,
   argument ] ...
);
int _sscanf_s_l(
   const char *buffer,
   const char *format,
   _locale_t locale [,
   argument ] ...
);
int swscanf_s(
   const wchar_t *buffer,
   const wchar_t *format [,
   argument ] ...
);
int _swscanf_s_l(
   const wchar_t *buffer,
   const wchar_t *format,
   _locale_t locale [,
   argument ] ...
);

매개 변수

buffer
저장된 데이터

format
형식 컨트롤 문자열입니다. 자세한 내용은 형식 사양 필드 scanf 및 wscanf 함수를 참조하세요.

argument
선택형 인수

locale
사용할 로캘입니다.

반환 값

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

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

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

설명

sscanf_s 함수는 각 argument에서 제공하는 위치로 buffer의 데이터를 읽습니다. 형식 문자열 뒤의 인수는 format의 형식 지정자에 해당하는 형식의 변수에 대한 포인터를 지정합니다. 보안 수준이 낮은 버전인 sscanf와는 달리 형식 필드 문자 c, C, s, S 또는 []로 묶은 문자열 제어 집합을 사용할 때는 버퍼 크기 매개 변수가 필요합니다. 문자의 버퍼 크기는 필요한 각 버퍼 매개 변수 바로 뒤의 추가 매개 변수로 제공되어야 합니다. 예를 들어 문자열을 읽는 경우 해당 문자열의 버퍼 크기는 다음과 같이 전달됩니다.

wchar_t ws[10];
swscanf_s(in_str, L"%9s", ws, (unsigned)_countof(ws)); // buffer size is 10, width specification is 9

버퍼 크기에는 종료 null이 포함되어 있습니다. 너비 사양 필드를 사용하면 읽은 토큰이 버퍼에 맞는지 확인할 수 있습니다. 너비 사양 필드가 사용되지 않고 읽은 토큰이 너무 커서 버퍼에 맞지 않으면 해당 버퍼에 기록되지 않습니다.

단일 문자는 다음과 같이 읽을 수 있습니다.

wchar_t wc;
swscanf_s(in_str, L"%c", &wc, 1);

이 예제에서는 입력 문자열에서 문자 하나를 읽은 다음 와이드 문자 버퍼에 저장합니다. null로 종료되지 않는 문자열의 여러 문자를 읽을 때는 너비 사양 및 버퍼 크기로 부호 없는 정수를 사용합니다.

char c[4];
sscanf_s(input, "%4c", &c, (unsigned)_countof(c)); // not null terminated

자세한 내용은 , _scanf_s_l, wscanf_s_wscanf_s_l 및 scanf 형식 필드 문자를 참조scanf_s하세요.

참고 항목

크기 매개 변수는 size_t가 아니라 unsigned 형식입니다. 64비트 대상을 컴파일하는 경우에는 정적 캐스팅을 사용하여 _countof 또는 sizeof 결과를 정확한 크기로 변환합니다.

format 인수는 입력 필드의 해석을 제어하며, 형식과 기능은 scanf_s 함수의 format 인수와 동일합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

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

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE 정의 _MBCS 되지 않음 _MBCS 정의 _UNICODE 정의
_stscanf_s sscanf_s sscanf_s swscanf_s
_stscanf_s_l _sscanf_s_l _sscanf_s_l _swscanf_s_l

요구 사항

루틴에서 반환된 값 필수 헤더
sscanf_s, _sscanf_s_l <stdio.h>
swscanf_s, _swscanf_s_l <stdio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_sscanf_s.c
// This program uses sscanf_s to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>
#include <stdlib.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 plus null terminator
   sscanf_s( tokenstring, "%s", s, (unsigned)_countof(s) );
   sscanf_s( tokenstring, "%c", &c, (unsigned)sizeof(char) );
   sscanf_s( tokenstring, "%d", &i );
   sscanf_s( tokenstring, "%f", &fp );

   // Output the data read
   printf_s( "String    = %s\n", s );
   printf_s( "Character = %c\n", c );
   printf_s( "Integer:  = %d\n", i );
   printf_s( "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