vsprintf, _vsprintf_l, vswprintf, _vswprintf_l__vswprintf_l

인수 목록에 대한 포인터를 사용하여 형식이 지정된 출력값을 씁니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 참조 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
이 함수의 와이드 문자열 버전에 저장할 최대 문자 수입니다.

format
형식 사양.

argptr
인수 목록에 대한 포인터입니다.

locale
사용할 로캘입니다.

반환 값

vsprintf vswprintf 그리고 종료 NULL 문자를 포함하지 않고 쓰여진 문자의 수를 반환하거나, 출력 오류가 발생하면 음수 값을 반환합니다. OR buffer 이 포인터인 format 경우 NULL 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 실행을 계속할 수 있는 경우 이러한 함수는 -1를 반환하고 로 설정합니다 errnoEINVAL.

포인터이고 bufferNULL 0 countvswprintf 인 경우 _vswprintf_l 종료 NULL을 포함하지 않고 작성되었을 문자 수를 반환합니다.

가 buffer 유효하고 count 0 vswprintf_vswprintf_l 이면 -1을 반환합니다. 의 buffer 내용은 변경되지 않습니다.

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

비고

이러한 각 함수는 인수 목록에 대한 포인터를 취한 다음 지정된 데이터를 형식이 지정된 메모리에 buffer씁니다.

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

vswprintf ISO C 표준을 준수하며, count이 표준에는 유형 size_t의 두 번째 매개 변수 가 필요합니다. 이전의 비표준 동작을 강제 실행하려면 를 정의하십시오 _CRT_NON_CONFORMING_SWPRINTFS. 이전 동작은 이후 버전에 없을 수 있으므로 새 준수 동작을 사용하도록 코드를 변경해야 합니다.

C++에서 이러한 함수에는 이러한 함수의 새롭고 안전한 함수를 호출하는 템플릿 오버로드가 있습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.

일반 텍스트 루틴 매핑

요구 사항

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

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

예시

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

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

void test( char const * const 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) );
    if ( 0 != buffer )
    {
        vsprintf( buffer, format, args ); // C4996
        // Note: vsprintf is deprecated; consider using vsprintf_s instead
        puts( buffer );

        free( buffer );
    }
    va_end( args );
}

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

123 < 456
This is a string

참고하십시오

스트림 I/O
vprintf 함수
형식 사양 구문: printf 및 wprintf 함수
fprintf, _fprintf_l, fwprintf_fwprintf_l
printf, _printf_l, wprintf_wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
va_arg, va_copy, va_endva_start