_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l

아티클
06/09/2015

사용 되는 인수의 순서를 지정하는 기능과 함께 인수 목록에 대한 포인터를 사용하여 형식이 지정 된 출력을 작성합니다.

int _vsprintf_p(
   char *buffer,
   size_t sizeInBytes,
   const char *format,
   va_list argptr 
); 
int _vsprintf_p_l(
   char *buffer,
   size_t sizeInBytes,
   const char *format,
   locale_t locale,
   va_list argptr 
); 
int _vswprintf_p(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   va_list argptr 
);
int _vswprintf_p_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

매개 변수

buffer
출력을 위한 저장소 위치입니다.
sizeInBytes
문자에서의 buffer 크기 입니다.
count
이 함수의 유니코드 버전을 저장하는 문자의 최대 수.
format
형식 사양입니다.
argptr
인수 목록에 대한 포인터입니다.
locale
사용할 로캘입니다.

반환 값

_vsprintf_p 및 _vswprintf_p 은 NULL 문자로 끝나거나 오류가 발생한 경우의 네이티브 값을 제외한 작성된 문자의 수를 반환합니다.

설명

이러한 함수의 각각은 인수 목록에 대한 포인터를 가지며, 서식을 지정하고 지정된 데이터를 buffer 가 가르키는 메모리에 작성합니다.

이러한 함수는 vsprintf_s 및 vswprintf_s 와 해당 위치 매개 변수를 지원하는 것 만 다릅니다. 자세한 내용은 printf_p 위치 매개 변수을 참조하십시오.

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

buffer 또는 format 매개 변수가 NULL 포인터인 경우, count가 0 인 경우, 형식 문자열이 잘못된 서식 문자열을 포함하는 경우 매개 변수 유효성 검사 에 설명된 대로 잘못된 매개 변수 처리기가 호출 됩니다. 계속해서 실행하도록 허용된 경우, 함수는 -1을 반환하고 errno 를 EINVAL로 설정합니다.

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_vstprintf_p	_vsprintf_p	_vsprintf_p	_vswprintf_p
_vstprintf_p_l	_vsprintf_p_l	_vsprintf_p_l	_vswprintf_p_l

요구 사항

루틴	필수 헤더	선택적 헤더
_vsprintf_p, _vsprintf_p_l	<stdio.h> 과 <stdarg.h>	<varargs.h>*
_vswprintf_p, _vswprintf_p_l	<stdio.h> 또는 <wchar.h>, 및 <stdarg.h>	<varargs.h>*

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

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

예제

// crt__vsprintf_p.c
// This program uses vsprintf_p to write to a buffer.
// The size of the buffer is determined by _vscprintf_p.

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


void example( char * format, ... )
{
    va_list  args;
    int      len;
    char     *buffer = NULL;

    va_start( args, format );

    // _vscprintf doesn't count the 
    // null terminating string so we add 1.
    len = _vscprintf_p( format, args ) + 1;

    // Allocate memory for our buffer
    buffer = (char*)malloc( len * sizeof(char) );
    if (buffer)
    {
        _vsprintf_p( buffer, len, format, args );
        puts( buffer );
        free( buffer );
    }
}


int main( void )
{
    // First example
    example( "%2$d %1$c %3$d", '<', 123, 456 );

    // Second example
    example( "%s", "This is a string" );
}