_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l

아티클
02/21/2013

매개 변수 형식 문자열에서 사용 되는 순서를 지정 하는 기능 문자열을 서식이 지정 된 데이터를 작성 합니다.

int _sprintf_p(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format [,
   argument] ... 
);
int _sprintf_p_l(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _swprintf_p(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format [,
   argument]...
);
int _swprintf_p_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   locale_t locale [,
   argument] … 
);

매개 변수

buffer
출력에 대 한 저장소 위치
sizeOfBuffer
최대 문자 수를 저장할 수 있습니다.
format
컨트롤 서식 문자열
argument
선택적 인수
locale
사용 하는 로캘.

자세한 내용은 형식 사양을.

반환 값

수 자 기록, 또는 오류가 발생 한 경우-1입니다.

설명

_sprintf_p 함수는 서식을 지정 하는 일련의 문자 및 값을 저장 buffer.각 argument (있는 경우)이 고 변환 출력에 해당 형식 사양에 따라 format.일반 문자로 이루어진 형식과 같은 형성 및 역할을 가진 해당 format 인수에 대 한 printf_p.A NULL 쓴 마지막 문자 다음 문자를 추가 합니다.중복 문자열 사이의 복사 발생 하는 경우 동작이 정의 되지 않습니다.차이 _sprintf_p 및 sprintf_s 입니다 _sprintf_p 형식 문자열의 인수가 사용 순서 지정 수 있습니다 지 원하는 위치 매개 됩니다.자세한 내용은 printf_p Positional 매개 변수를 참조하십시오.

_swprintf_p와이드 문자 버전입니다 _sprintf_p. 포인터 인수에 _swprintf_p 와이드 문자 문자열입니다.인코딩 오류를 감지 _swprintf_p 에 있는 다를 수 있습니다 _sprintf_p._swprintf_p및 fwprintf_p 동일 하 게 동작 _swprintf_p 대상 형식 대신 문자열 출력을 기록 FILE, 및 _swprintf_p 필요의 count최대 쓸 문자 수를 지정 하는 매개 변수입니다.버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.

_sprintf_p저장 되는 바이트 수를 반환 합니다. buffer, 종료 계산 NULL 문자입니다._swprintf_p저장 된 와이드 문자 수를 반환 합니다. buffer, 종료 계산 NULL 와이드 문자입니다.경우 buffer 또는 format 는 null 포인터 또는 서식 문자를 잘못 된 형식 문자열에 있는 경우 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.이 함수 실행을 계속 수 있으면-1을 반환 합니다. 설정 하 고 errno 에 EINVAL.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_stprintf_p	_sprintf_p	_sprintf_p	_swprintf_p
_stprintf_p_l	_sprintf_p_l	_sprintf_p_l	_swprintf_p_l

요구 사항

루틴	필수 헤더
_sprintf_p, _sprintf_p_l	<stdio.h>
_swprintf_p, _swprintf_p_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_sprintf_p.c
// This program uses _sprintf_p to format various
// data and place them in the string named buffer.
//

#include <stdio.h>

int main( void )
{
    char     buffer[200],
            s[] = "computer", c = 'l';
    int      i = 35,
            j;
    float    fp = 1.7320534f;

    // Format and print various data: 
    j  = _sprintf_p( buffer, 200,
                     "   String:    %s\n", s );
    j += _sprintf_p( buffer + j, 200 - j, 
                     "   Character: %c\n", c );
    j += _sprintf_p( buffer + j, 200 - j, 
                     "   Integer:   %d\n", i );
    j += _sprintf_p( buffer + j, 200 - j, 
                     "   Real:      %f\n", fp );

    printf( "Output:\n%s\ncharacter count = %d\n", 
            buffer, j );
}

// crt_swprintf_p.c
// This is the wide character example which
// also demonstrates _swprintf_p returning
// error code.
#include <stdio.h>

#define BUFFER_SIZE 100

int main( void )
{
    wchar_t buffer[BUFFER_SIZE];
    int     len;

    len = _swprintf_p(buffer, BUFFER_SIZE, L"%2$s %1$d",
                      0, L" marbles in your head.");
    _printf_p( "Wrote %d characters\n", len );
    
    // _swprintf_p fails because string contains WEOF (\xffff)
    len = _swprintf_p(buffer, BUFFER_SIZE, L"%s", 
                      L"Hello\xffff world" );
    _printf_p( "Wrote %d characters\n", len );
}