vsscanf_s, vswscanf_s
문자열에서 형식이 지정된 데이터를 읽습니다. 이러한 버전은 CRT의 vswscanfvsscanf 보안 기능에 설명된 대로 향상된 보안 기능을 제공합니다.
구문
int vsscanf_s(
const char *buffer,
const char *format,
va_list argptr
);
int vswscanf_s(
const wchar_t *buffer,
const wchar_t *format,
va_list arglist
);
매개 변수
buffer
저장된 데이터
format
형식 컨트롤 문자열입니다. 자세한 내용은 형식 사양 필드 scanf 및 wscanf 함수를 참조하세요.
arglist
가변 인수 목록입니다.
반환 값
이러한 각 함수는 성공적으로 변환되고 할당된 필드 수를 반환합니다. 반환 값에는 읽었으나 할당되지 않은 필드가 포함되지 않습니다. 반환 값이 0이면 할당된 필드가 없음을 나타냅니다. 오류가 발생하거나 첫 번째 변환 전에 문자열의 끝에 도달할 경우 반환 값은 EOF입니다.
포인터이거나 format 포인터인 NULL 경우 buffer 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우 이러한 함수가 -1을 반환하고 errno 를 EINVAL로 설정합니다.
이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno, _sys_errlist및_sys_nerr 를 참조하세요errno.
설명
vsscanf_s 함수는 arglist 인수 목록의 각 인수가 제공하는 위치로 buffer의 데이터를 읽습니다. 인수 목록의 인수는 format의 형식 지정자에 해당하는 형식의 변수에 대한 포인터를 지정합니다. 보안이 낮은 버전vsscanf과 달리 []로 묶인 형식 필드 문자 c, C, s, S 또는 문자열 제어 집합을 사용하는 경우 버퍼 크기 매개 변수가 필요합니다. 문자의 버퍼 크기는 필요한 각 버퍼 매개 변수 바로 뒤의 다른 매개 변수로 제공되어야 합니다.
버퍼 크기에는 종료 null이 포함되어 있습니다. 너비 사양 필드를 사용하면 읽은 토큰이 버퍼에 맞는지 확인할 수 있습니다. 너비 사양 필드가 사용되지 않고 읽은 토큰이 너무 커서 버퍼에 맞지 않으면 해당 버퍼에 기록되지 않습니다.
자세한 내용은 ,_scanf_s_l, wscanf_s _wscanf_s_l및 scanf 형식 필드 문자를 참조scanf_s하세요.
참고 항목
크기 매개 변수는 size_t가 아니라 unsigned 형식입니다.
format 인수는 입력 필드의 해석을 제어하며, 형식과 기능은 scanf_s 함수의 format 인수와 동일합니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.
vswscanf_s 는 vsscanf_s의 와이드 문자 버전이며, vswscanf_s 에 대한 인수는 와이드 문자 문자열입니다. vsscanf_s 는 멀티바이트 16진수 문자를 처리하지 않습니다. vswscanf_s 는 유니코드 전폭 16진수 또는 "호환성 영역" 문자를 처리하지 않습니다. 그렇지 않으면 vswscanf_s 과 vsscanf_s 은 동일하게 작동합니다.
일반 텍스트 루틴 매핑
| TCHAR.H 루틴 | _UNICODE 및 _MBCS 정의되지 않음 |
정의된 _MBCS |
정의된 _UNICODE |
|---|---|---|---|
_vstscanf_s |
vsscanf_s |
vsscanf_s |
vswscanf_s |
요구 사항
| 루틴에서 반환된 값 | 필수 헤더 |
|---|---|
vsscanf_s |
<stdio.h> |
vswscanf_s |
<stdio.h> 또는 <wchar.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// crt_vsscanf_s.c
// compile with: /W3
// This program uses vsscanf_s to read data items
// from a string named tokenstring, then displays them.
#include <stdio.h>
#include <stdarg.h>
#include <stdlib.h>
int call_vsscanf_s(char *tokenstring, char *format, ...)
{
int result;
va_list arglist;
va_start(arglist, format);
result = vsscanf_s(tokenstring, format, arglist);
va_end(arglist);
return result;
}
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:
call_vsscanf_s(tokenstring, "%80s", s, _countof(s));
call_vsscanf_s(tokenstring, "%c", &c, sizeof(char));
call_vsscanf_s(tokenstring, "%d", &i);
call_vsscanf_s(tokenstring, "%f", &fp);
// 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
scanf, _scanf_l, wscanf_wscanf_l
sscanf, _sscanf_l, swscanf_swscanf_l
sscanf_s, _sscanf_s_l, swscanf_s_swscanf_s_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
vsscanf, vswscanf