다음을 통해 공유


_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l

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

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 Positional 매개 변수를 참조하십시오.

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

경우는 buffer 또는 format 매개 변수는 NULL 포인터 카운트 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> *

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

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

예제

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

해당 .NET Framework 항목

System::String::Format

참고 항목

참조

스트림 I/O

vprintf 함수

형식 사양 구문: printf 및 wprintf 함수

않는다면, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

va_start, va_end, va_arg