vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l

아티클
06/09/2015

인수 목록에 대한 포인터를 사용하여 서식이 지정된 출력을 작성합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. 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],
   const wchar_t *format,
   va_list argptr 
); // C++ only
template <size_t size>
int _vswprintf_l(
   wchar_t (&buffer)[size],
   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이 사용자 정의 문자열이 아닌지도 확인하십시오.자세한 내용은 버퍼 오버런 방지를 참조하십시오.

vsprintf 을 사용하면 작성된 문자의 수를 제한할 방법이 없습니다. 즉, 이러한 함수를 사용한 코드는 버퍼 초과를 허용합니다.얼마나 많은 버퍼가 필요한지 결정하려면 대신에 _vsnprintf 를 사용하거나 _vscprintf 를 호출하십시오.format이 사용자 정의 문자열이 아닌지도 확인하십시오.자세한 내용은 버퍼 오버런 방지를 참조하십시오.

vswprintf는 size_t 형식의 두 번째 매개 변수인 count를 요구하는 ISO C 표준을 준수합니다. 오래된 비표준 동작을 동작시키려면 _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>*

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

호환성에 대한 자세한 내용은 소개 단원의 호환성 부분을 참조하십시오.

예제

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