vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l

아티클
02/21/2013

인수 목록에 대 한 포인터를 사용 하 여 형식이 지정 된 출력을 작성 합니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l.

int vsprintf(
   char *buffer,
   const char *format,
   va_list argptr 
); 
int _vsprintf_l(
   char *buffer,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int vswprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
int __vswprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);
template <size_t size>
int vsprintf(
   char (&buffer)[size],
   const char *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vsprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale,
   va_list argptr 
); // C++ only
template <size_t size>
int vswprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
); // C++ only

매개 변수

buffer
출력에 대 한 저장소 위치입니다.
count
최대 문자를 저장 하는 UNICODE 버전의이 함수입니다.
format
형식 사양입니다.
argptr
인수 목록에 대 한 포인터입니다.
locale
사용 하는 로캘.

반환 값

vsprintf및 vswprintf 출력 오류가 발생 하는 경우 음수 값 또는 null 종결 문자를 포함 하지 않음 쓴 문자 수를 반환 합니다.경우 buffer 또는 format 는 null 포인터에 설명 된 대로 이러한 함수가 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사.이 함수 실행을 계속 수 있으면-1을 반환 합니다. 설정 하 고 errno 에 EINVAL.

이러한 문제 및 기타 오류 코드에 대 한 내용은 _doserrno, errno, _sys_errlist, 및 _sys_nerr.

설명

각이 함수 인수 목록에 대 한 포인터를 사용 하 고 다음 서식을 지정 하 고 주어진된 데이터 포인터가 가리키는 메모리를 기록 buffer.

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

보안 정보
사용 하 여 vsprintf, 여기 코드를이 함수를 사용 하 여 버퍼 오버런에 취약 하 게 되는 문자 수를 제한할 수 없습니다 작성 됩니다.사용 _vsnprintf 대신, 호출 또는 _vscprintf 얼마나 큰 버퍼가 필요한 지 결정 하십시오.또한, 확인 format 사용자 정의 문자열이 아닙니다.자세한 내용은 버퍼 오버런 방지.

vswprintfISO C 두 번째 매개 변수를 필요로 하는 표준 준수 count, 형식 size_t.이전의 비표준 동작을 강제로 정의 _CRT_NON_CONFORMING_SWPRINTFS. 새 규칙 동작을 사용 하려면 코드를 변경 해야 하므로 이후 버전에서 이전 버전의 동작 수 없습니다.

C + +에서이 함수는 최신, 보안 상응 하는 이러한 함수를 호출 하는 템플릿 오버 로드 되어 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_vstprintf	vsprintf	vsprintf	vswprintf
_vstprintf_l	_vsprintf_l	_vsprintf_l	_vswprintf_l

요구 사항

루틴	필수 헤더	선택적 헤더
vsprintf, _vsprintf_l	<stdio.h> 및 <stdarg.h>	<varargs.h> *
vswprintf, _vswprintf_l	<stdio.h> 또는 <wchar.h> 및 <stdarg.h>	<varargs.h> *

* V UNIX 호환성을 위해 필요 합니다.

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_vsprintf.c
// compile with: /W3
// This program uses vsprintf to write to a buffer.
// The size of the buffer is determined by _vscprintf.

#include <stdlib.h>
#include <stdio.h>
#include <stdarg.h>

void test( char * format, ... )
{
    va_list args;
    int     len;
    char    *buffer;

    // retrieve the variable arguments
    va_start( args, format );
    
    len = _vscprintf( format, args ) // _vscprintf doesn't count
                                + 1; // terminating '\0'
    
    buffer = (char*)malloc( len * sizeof(char) );

    vsprintf( buffer, format, args ); // C4996
    // Note: vsprintf is deprecated; consider using vsprintf_s instead
    puts( buffer );

    free( buffer );
}

int main( void )
{
   test( "%d %c %d", 123, '<', 456 );
   test( "%s", "This is a string" );
}