_snwprintf_l, _snwprintf, _snprintf_l, _snprintf
서식이 지정 된 데이터 문자열을 씁니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l.
int _snprintf(
char *buffer,
size_t count,
const char *format [,
argument] ...
);
int _snprintf_l(
char *buffer,
size_t count,
const char *format,
locale_t locale [,
argument] ...
);
int _snwprintf(
wchar_t *buffer,
size_t count,
const wchar_t *format [,
argument] ...
);
int _snwprintf_l(
wchar_t *buffer,
size_t count,
const wchar_t *format,
locale_t locale [,
argument] ...
);
template <size_t size>
int _snprintf(
char (&buffer)[size],
size_t count,
const char *format [,
argument] ...
); // C++ only
template <size_t size>
int _snprintf_l(
char (&buffer)[size],
size_t count,
const char *format,
locale_t locale [,
argument] ...
); // C++ only
template <size_t size>
int _snwprintf(
wchar_t (&buffer)[size],
size_t count,
const wchar_t *format [,
argument] ...
); // C++ only
template <size_t size>
int _snwprintf_l(
wchar_t (&buffer)[size],
size_t count,
const wchar_t *format,
locale_t locale [,
argument] ...
); // C++ only
매개 변수
buffer
출력에 대 한 저장소 위치입니다.count
최대 문자 수를 저장할 수 있습니다.format
컨트롤 서식 문자열입니다.argument
선택적 인수입니다.locale
사용 하는 로캘.
자세한 내용은 형식 사양을.
반환 값
수 있도록 len 수 (종료 null 포함) 데이터 형식이 지정 된 문자열의 길이입니다.len및 count 에 대 한 바이트에 있는 _snprintf, 와이드 문자에 대 한 _snwprintf.
If len < count다음 len 문자에 저장 됩니다 buffer, null 종결자를 추가 하 고 len 이 반환 됩니다.
경우 len = count, 다음 len 문자에 저장 됩니다 buffer, null 종결자를 추가 하 고 len 이 반환 됩니다.
If len > count다음 count 문자에 저장 됩니다 buffernull 종결자를 추가 하 고 음수 값이 반환 됩니다.
경우 buffer 은 null 포인터입니다 및 count 0이 아닙니다 또는 format 은 null 포인터입니다.의 설명에 따라 잘못 된 매개 변수 처리기가 호출 매개 변수 유효성 검사.이 함수 실행을 계속 수 있으면-1을 반환 합니다. 설정 하 고 errno 에 EINVAL.
이러한 문제 및 기타 오류 코드에 대 한에 대 한 자세한 내용은 _doserrno, errno, _sys_errlist, 및 _sys_nerr.
설명
_snprintf 함수의 형식 및 저장소 count 또는 더 적은 문자를 buffer, 엄격 하 게 형식이 지정 된 문자열 길이입니다 경우 종료 null 문자를 추가 하 고 보다 작은 count 문자입니다.각 argument (있는 경우)이 고 변환 출력에 해당 형식 사양에 따라 format.일반 문자로 이루어진 형식과 같은 형성 및 역할을 가진 해당 format 인수에 대 한 printf.중복 문자열 사이의 복사 발생 하는 경우 동작이 정의 되지 않습니다.
![]() |
---|
확인 format 사용자 정의 문자열이 아닙니다.이 함수가 NULL 종료 하지 않을 수 있기 때문에 (특히 때 반환 값이 count)에 null 종결자를 추가 하는 코드에서 있는지 확인 하십시오.자세한 내용은 버퍼 오버런 방지. |
_snwprintf와이드 문자 버전입니다 _snprintf. 포인터 인수에 _snwprintf 와이드 문자 문자열입니다.인코딩 오류를 감지 _snwprintf 에 있는 다를 수 있습니다 _snprintf._snwprintf와 같은 swprintf, 대상 형식 대신 문자열 출력 기록 FILE.
버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.
C + +에서이 함수는 최신, 보안 상응 하는 이러한 함수를 호출 하는 템플릿 오버 로드 되어 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.
일반 텍스트 루틴 매핑
Tchar.h 루틴 |
_UNICODE 및 _mbcs가 정의 되지 않았습니다. |
_Mbcs가 정의 |
_Unicode가 정의 |
---|---|---|---|
_sntprintf |
_snprintf |
_snprintf |
_snwprintf |
_sntprintf_l |
_snprintf_l |
_snprintf_l |
_snwprintf_l |
요구 사항
루틴 |
필수 헤더 |
---|---|
_snprintf, _snprintf_l |
<stdio.h> |
_snwprintf, _snwprintf_l |
<stdio.h> 또는 <wchar.h> |
더 많은 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.
예제
// crt_snprintf.c
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>
#if !defined(__cplusplus)
typedef int bool;
const bool true = 1;
const bool false = 0;
#endif
#define FAIL 0 // change to 1 and see what happens
int main(void)
{
char buffer[200];
const static char s[] = "computer"
#if FAIL
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
#endif
;
const char c = 'l';
const int i = 35;
#if FAIL
const double fp = 1e300; // doesn't fit in the buffer
#else
const double fp = 1.7320534;
#endif
/* !subtract one to prevent "squeezing out" the terminal nul! */
const int bufferSize = sizeof(buffer)/sizeof(buffer[0]) - 1;
int bufferUsed = 0;
int bufferLeft = bufferSize - bufferUsed;
bool bSuccess = true;
buffer[0] = 0;
/* Format and print various data: */
if (bufferLeft > 0)
{
int perElementBufferUsed = _snprintf(&buffer[bufferUsed],
bufferLeft, " String: %s\n", s ); // C4996
// Note: _snprintf is deprecated; consider _snprintf_s instead
if (bSuccess = (perElementBufferUsed >= 0))
{
bufferUsed += perElementBufferUsed;
bufferLeft -= perElementBufferUsed;
if (bufferLeft > 0)
{
int perElementBufferUsed = _snprintf(&buffer[bufferUsed],
bufferLeft, " Character: %c\n", c ); // C4996
if (bSuccess = (perElementBufferUsed >= 0))
{
bufferUsed += perElementBufferUsed;
bufferLeft -= perElementBufferUsed;
if (bufferLeft > 0)
{
int perElementBufferUsed = _snprintf(&buffer
[bufferUsed], bufferLeft, " Integer: %d\n", i ); // C4996
if (bSuccess = (perElementBufferUsed >= 0))
{
bufferUsed += perElementBufferUsed;
bufferLeft -= perElementBufferUsed;
if (bufferLeft > 0)
{
int perElementBufferUsed = _snprintf(&buffer
[bufferUsed], bufferLeft, " Real: %f\n", fp ); // C4996
if (bSuccess = (perElementBufferUsed >= 0))
{
bufferUsed += perElementBufferUsed;
}
}
}
}
}
}
}
}
if (!bSuccess)
{
printf("%s\n", "failure");
}
else
{
/* !store nul because _snprintf doesn't necessarily (if the string
* fits without the terminal nul, but not with it)!
* bufferUsed might be as large as bufferSize, which normally is
* like going one element beyond a buffer, but in this case
* subtracted one from bufferSize, so we're ok.
*/
buffer[bufferUsed] = 0;
printf( "Output:\n%s\ncharacter count = %d\n", buffer, bufferUsed );
}
return EXIT_SUCCESS;
}
해당 .NET Framework 항목
해당 사항 없음. 표준 C 함수를 호출할 수 있습니다 PInvoke. 자세한 내용은 플랫폼 호출 예제.
참고 항목
참조
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
않는다면, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l