vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l
인수 목록에 대 한 포인터를 사용 하 여 형식이 지정 된 출력을 작성 합니다.이러한 버전의 있습니다 vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.
int vsprintf_s(
char *buffer,
size_t numberOfElements,
const char *format,
va_list argptr
);
int _vsprintf_s_l(
char *buffer,
size_t numberOfElements,
const char *format,
locale_t locale,
va_list argptr
);
int vswprintf_s(
wchar_t *buffer,
size_t numberOfElements,
const wchar_t *format,
va_list argptr
);
int _vswprintf_s_l(
wchar_t *buffer,
size_t numberOfElements,
const wchar_t *format,
locale_t locale,
va_list argptr
);
template <size_t size>
int vsprintf_s(
char (&buffer)[size],
const char *format,
va_list argptr
); // C++ only
template <size_t size>
int vswprintf_s(
wchar_t (&buffer)[size],
const wchar_t *format,
va_list argptr
); // C++ only
매개 변수
buffer
출력에 대 한 저장소 위치입니다.numberOfElements
크기를 buffer 문자 수입니다.format
형식 사양입니다.argptr
인수 목록에 대 한 포인터입니다.locale
사용 하는 로캘.
반환 값
vsprintf_s및 vswprintf_s 출력 오류가 발생 하는 경우 음수 값 또는 null 종결 문자를 포함 하지 않음 쓴 문자 수를 반환 합니다.경우 buffer 또는 format count가 0 이면 null 포인터 또는 서식 문자를 잘못 된 형식 문자열에 있는 경우 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.실행 계속 수 있으면 함수는-1을 반환 하 고 설정 errno 에 EINVAL.
이러한 문제 및 기타 오류 코드에 대 한 내용은 _doserrno, errno, _sys_errlist, 및 _sys_nerr.
설명
각이 함수 인수 목록에 대 한 포인터를 사용 하 고 다음 서식을 지정 하 고 주어진된 데이터 포인터가 가리키는 메모리를 기록 buffer.
vswprintf_sISO C 표준에 맞는 vswprintf, 두 번째 매개 변수를 필요로 하는 count, 형식 size_t.
이러한 함수 보안 되지 않은 버전에서 달리는 보안 버전 위치 매개 변수를 지원 합니다.자세한 내용은 printf_p Positional 매개 변수를 참조하십시오.
버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.
C + +에서이 함수를 사용 하 여 템플릿 오버 로드에 단순화 됩니다. 오버 로드에서 버퍼 길이가 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없습니다) 및 해당 보안에서 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.
일반 텍스트 루틴 매핑
TCHAR입니다.H 루틴 |
_UNICODE 및 _Mbcs가 정의 되지 않았습니다. |
_Mbcs가 정의 |
_Unicode가 정의 |
---|---|---|---|
_vstprintf_s |
vsprintf_s |
vsprintf_s |
vswprintf_s |
_vstprintf_s_l |
_vsprintf_s_l |
_vsprintf_s_l |
_vswprintf_s_l |
요구 사항
루틴 |
필수 헤더 |
선택적 헤더 |
---|---|---|
vsprintf_s, _vsprintf_s_l |
<stdio.h> 및 <stdarg.h> |
<varargs.h> * |
vswprintf_s, _vswprintf_s_l |
<stdio.h> 또는 <wchar.h> 및 <stdarg.h> |
<varargs.h> * |
* V UNIX 호환성을 위해 필요 합니다.
추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
예제
// crt_vsprintf_s.c
// This program uses vsprintf_s to write to a buffer.
// The size of the buffer is determined by _vscprintf.
#include <stdlib.h>
#include <stdarg.h>
void test( char * format, ... )
{
va_list args;
int len;
char * buffer;
va_start( args, format );
len = _vscprintf( format, args ) // _vscprintf doesn't count
+ 1; // terminating '\0'
buffer = malloc( len * sizeof(char) );
vsprintf_s( buffer, len, format, args );
puts( buffer );
free( buffer );
}
int main( void )
{
test( "%d %c %d", 123, '<', 456 );
test( "%s", "This is a string" );
}
해당 .NET Framework 항목
참고 항목
참조
않는다면, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l