vprintf, vfprintf, vsprintf, vsnprintf, vprintf_s, vfprintf_s, vsprintf_s, vsnprintf_s
|
헤더 파일에 정의됨
<stdio.h>
|
||
| (1) | ||
|
int
vprintf
(
const
char
*
format, va_list vlist
)
;
|
(C99 이전) | |
|
int
vprintf
(
const
char
*
restrict
format, va_list vlist
)
;
|
(C99 이후) | |
| (2) | ||
|
int
vfprintf
(
FILE
*
stream,
const
char
*
format, va_list vlist
)
;
|
(C99 이전) | |
|
int
vfprintf
(
FILE
*
restrict
stream,
const
char
*
restrict
format,
va_list vlist ) ; |
(C99 이후) | |
| (3) | ||
|
int
vsprintf
(
char
*
buffer,
const
char
*
format, va_list vlist
)
;
|
(C99 이전) | |
|
int
vsprintf
(
char
*
restrict
buffer,
const
char
*
restrict
format,
va_list vlist ) ; |
(C99 이후) | |
|
int
vsnprintf
(
char
*
restrict
buffer,
size_t
bufsz,
const char * restrict format, va_list vlist ) ; |
(4) | (C99 이후) |
|
int
vprintf_s
(
const
char
*
restrict
format, va_list vlist
)
;
|
(5) | (C11 이후) |
|
int
vfprintf_s
(
FILE
*
restrict
stream,
const
char
*
restrict
format,
va_list vlist ) ; |
(6) | (C11 이후) |
|
int
vsprintf_s
(
char
*
restrict
buffer, rsize_t bufsz,
const char * restrict format, va_list vlist ) ; |
(7) | (C11 이후) |
|
int
vsnprintf_s
(
char
*
restrict
buffer, rsize_t bufsz,
const char * restrict format, va_list vlist ) ; |
(8) | (C11 이후) |
vlist 로 정의된 위치들에서 데이터를 로드하고, 이를 문자열 형태로 변환한 후 다양한 출력 대상에 결과를 기록합니다.
-
-
변환 지정자
%n이 format 에 존재하는 경우 -
%s에 해당하는 인자 중 null pointer가 있는 경우 - format 이나 buffer 가 null pointer인 경우
- bufsz 가 0이거나 RSIZE_MAX 보다 큰 경우
- 문자열 및 문자 변환 지정자에서 인코딩 오류가 발생하는 경우
-
(
vsprintf_s에만 해당) buffer 에 저장될 문자열(종료 null 문자 포함)이 bufsz 를 초과하는 경우
-
변환 지정자
vprintf_s
,
vfprintf_s
,
vsprintf_s
, 그리고
vsnprintf_s
는 구현체가
__STDC_LIB_EXT1__
를 정의하고, 사용자가
<stdio.h>
를 포함하기 전에
__STDC_WANT_LIB_EXT1__
를 정수 상수
1
으로 정의한 경우에만 사용 가능함이 보장됩니다.
목차 |
매개변수
| stream | - | 출력할 파일 스트림 |
| buffer | - | 출력할 문자열에 대한 포인터 |
| bufsz | - | 최대 bufsz - 1 개의 문자와 널 종결자를 기록할 수 있음 |
| format | - | 데이터 해석 방법을 지정하는 널 종결 문자열에 대한 포인터 |
| vlist | - | 출력할 데이터를 포함하는 가변 인수 목록 |
format
문자열은 일반 바이트 문자(단,
%
제외)와 변환 지정자로 구성됩니다. 일반 바이트 문자는 변경 없이 출력 스트림에 복사되며, 각 변환 지정자는 다음 형식을 가집니다:
-
-
서론적인
%문자입니다.
-
서론적인
-
- (선택적) 변환 동작을 수정하는 하나 이상의 플래그:
-
-
-: 변환 결과가 필드 내에서 왼쪽 정렬됩니다 (기본값은 오른쪽 정렬). -
+: 부호 있는 변환의 경우 결과 앞에 항상 부호가 붙습니다 (기본값은 음수일 때만 마이너스 부호가 붙음). -
space
: 부호 있는 변환 결과가 부호 문자로 시작하지 않거나 비어 있는 경우, 결과 앞에 공백이 추가됩니다.
+플래그가 존재할 경우 무시됩니다. -
#: 변환의 대체 형태 가 수행됩니다. 정확한 효과는 아래 표를 참조하십시오. 그렇지 않을 경우 동작은 정의되지 않습니다. -
0: 정수 및 부동 소수점 숫자 변환의 경우, space 문자 대신 선행 영(0)이 필드를 채우는 데 사용됩니다. 정수 숫자의 경우 정밀도가 명시적으로 지정되면 무시됩니다. 다른 변환에서 이 플래그를 사용하면 동작이 정의되지 않습니다.-플래그가 존재할 경우 무시됩니다.
-
-
-
(선택 사항)
정수 값 또는
*으로 최소 필드 너비를 지정합니다. 결과는 필요한 경우 오른쪽 정렬 시 왼쪽에, 왼쪽 정렬 시 오른쪽에 공백 문자(기본값)로 채워집니다.*이 사용되는 경우, 너비는 int 타입의 추가 인수로 지정되며, 이 인수는 변환할 인수와 정밀도를 제공하는 인수(있는 경우) 앞에 나타납니다. 인수 값이 음수인 경우-플래그가 지정되고 양의 필드 너비로 처리됩니다(참고: 이는 최소 너비이며 값은 절대 잘리지 않습니다).
-
(선택 사항)
정수 값 또는
-
-
(선택적)
.뒤에 정수 숫자나*이 오거나 아무것도 오지 않으며, 이는 변환의 정밀도(precision) 를 지정합니다.*가 사용되는 경우, 정밀도(precision) 는 int 타입의 추가 인수로 지정되며, 이 인수는 변환될 인수 앞에 나타나지만, 최소 필드 너비를 공급하는 인수가 제공된 경우 그 뒤에 옵니다. 이 인수의 값이 음수이면 무시됩니다. 숫자나*가 사용되지 않으면 정밀도는 0으로 간주됩니다. 정밀도(precision) 의 정확한 효과에 대해서는 아래 표를 참조하십시오.
-
(선택적)
-
- (선택적) 길이 수정자 는 인수의 크기를 지정합니다 (변환 형식 지정자와 결합하여 해당 인수의 유형을 지정합니다).
-
- 변환 형식 지정자.
다음 형식 지정자를 사용할 수 있습니다:
|
변환
지정자 |
설명 |
기대되는
인수 타입 |
||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 길이 수정자→ | hh | h | 없음 | l | ll | j | z | t | L | |
| C99 이후로만 사용 가능→ | 예 | 예 | 예 | 예 | 예 | |||||
%
|
리터럴
%
를 출력합니다. 전체 변환 지정자는
%%
이어야 합니다.
|
N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
c
|
단일 문자 를 출력합니다.
|
N/A | N/A |
int
|
wint_t
|
N/A | N/A | N/A | N/A | N/A |
s
|
문자열 을 기록합니다.
|
N/A | N/A |
char
*
|
wchar_t
*
|
N/A | N/A | N/A | N/A | N/A |
d
i
|
부호 있는 정수 를 10진수 표현 [-]dddd 로 변환합니다.
|
signed
char
|
short
|
int
|
long
|
long
long
|
※
|
N/A | ||
o
|
부호 없는 정수 를 8진수 표현 oooo 로 변환합니다.
|
unsigned
char
|
unsigned
short
|
unsigned
int
|
unsigned
long
|
unsigned
long
long
|
ptrdiff_t
의 부호 없는 버전
|
해당 없음 | ||
x
X
|
부호 없는 정수 를 16진수 표현 hhhh 로 변환합니다.
|
N/A | ||||||||
u
|
부호 없는 정수 를 10진수 표현 dddd 로 변환합니다.
|
N/A | ||||||||
f
F
(C99)
|
부동 소수점 숫자 를 [-]ddd.ddd 스타일의 10진수 표기법으로 변환합니다.
|
N/A | N/A |
double
|
double
(C99)
|
N/A | N/A | N/A | N/A |
long
double
|
e
E
|
부동 소수점 숫자 를 10진수 지수 표기법으로 변환합니다.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
a
A
(C99) |
부동 소수점 숫자 를 16진수 지수 표기법으로 변환합니다.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
g
G
|
부동 소수점 숫자 를 값과 정밀도 에 따라 십진수 또는 십진수 지수 표기법으로 변환합니다.
|
N/A | N/A | N/A | N/A | N/A | N/A | |||
n
|
이 함수 호출로 지금까지 기록된 문자 수 를 반환합니다.
|
signed
char
*
|
short
*
|
int
*
|
long
*
|
long
long
*
|
intmax_t
*
|
※
|
N/A | |
p
|
구현 정의된 문자 시퀀스를 작성하여 포인터 를 정의합니다. |
N/A | N/A |
void
*
|
N/A | N/A | N/A | N/A | N/A | N/A |
| 참고 사항 | ||||||||||
|
부동 소수점 변환 함수는 무한대를
NaN(Not-a-Number)은
변환 지정자
char , unsigned char , signed char , short , 그리고 unsigned short 를 출력하는 데 사용되는 변환 지정자는 기본 인수 승격 의 승격된 타입을 기대하지만, 출력하기 전에 그 값은 char , unsigned char , signed char , short , 그리고 unsigned short 로 변환됩니다. 가변 인수 함수가 호출될 때 발생하는 승격 때문에 이러한 타입의 값을 전달하는 것은 안전합니다.
고정 너비 문자 타입(
int8_t
등)에 대한 올바른 변환 지정자는 헤더
<inttypes.h>
에 정의되어 있습니다(비록
PRIdMAX
,
PRIuMAX
등이
메모리 쓰기 변환 지정자
각 변환 지정자의 동작 후에는
시퀀스 포인트
가 있습니다; 이는 여러
변환 지정자가 유효하지 않으면 그 동작은 정의되지 않습니다. |
||||||||||
반환값
참고 사항
이 모든 함수들은 적어도 한 번 이상 va_arg 를 호출하며, 반환 후 arg 의 값은 정의되지 않습니다. 이러한 함수들은 va_end 를 호출하지 않으며, 호출자가 이를 수행해야 합니다.
vsnprintf_s
는
vsprintf_s
와 달리
buffer
가 가리키는 배열 내에 맞도록 결과를 잘라냅니다.
vsnprintf_s
의
Microsoft CRT
구현은 C 표준을 준수하지 않습니다. Microsoft 버전에는 세 번째 위치에 최대 작성 문자 수(널 종결자 제외)를 포함하는 추가 매개변수
size_t
count
가 있습니다. 이 매개변수는
size_t
bufsz
매개변수를 통해 제공된 버퍼 크기와 다를 수 있습니다.
예제
#include <stdarg.h> #include <stdio.h> #include <time.h> void debug_log(const char* fmt, ...) { struct timespec ts; timespec_get(&ts, TIME_UTC); char time_buf[100]; size_t rc = strftime(time_buf, sizeof time_buf, "%D %T", gmtime(&ts.tv_sec)); snprintf(time_buf + rc, sizeof time_buf - rc, ".%06ld UTC", ts.tv_nsec / 1000); va_list args1; va_start(args1, fmt); va_list args2; va_copy(args2, args1); char buf[1+vsnprintf(NULL, 0, fmt, args1)]; va_end(args1); vsnprintf(buf, sizeof buf, fmt, args2); va_end(args2); printf("%s [debug]: %s\n", time_buf, buf); } int main(void) { debug_log("Logging, %d, %d, %d", 1, 2, 3); }
가능한 출력:
02/20/15 21:58:09.072683 UTC [debug]: Logging, 1, 2, 3
참고문헌
- C23 표준 (ISO/IEC 9899:2024):
-
- 7.21.6.8 vfprintf 함수 (p: TBD)
-
- 7.21.6.10 vprintf 함수 (p: TBD)
-
- 7.21.6.12 vsnprintf 함수 (p: TBD)
-
- 7.21.6.13 vsprintf 함수 (p: TBD)
-
- K.3.5.3.8 vfprintf_s 함수 (p: TBD)
-
- K.3.5.3.10 vprintf_s 함수 (p: TBD)
-
- K.3.5.3.12 vsnprintf_s 함수 (p: TBD)
-
- K.3.5.3.13 vsprintf_s 함수 (p: TBD)
- C17 표준 (ISO/IEC 9899:2018):
-
- 7.21.6.8 vfprintf 함수 (p: 238)
-
- 7.21.6.10 vprintf 함수 (p: 239)
-
- 7.21.6.12 vsnprintf 함수 (p: 239-240)
-
- 7.21.6.13 vsprintf 함수 (p: 240)
-
- K.3.5.3.8 vfprintf_s 함수 (p: 434)
-
- K.3.5.3.10 vprintf_s 함수 (p: 435)
-
- K.3.5.3.12 vsnprintf_s 함수 (p: 436-437)
-
- K.3.5.3.13 vsprintf_s 함수 (p: 437)
- C11 표준 (ISO/IEC 9899:2011):
-
- 7.21.6.8 vfprintf 함수 (p: 326-327)
-
- 7.21.6.10 vprintf 함수 (p: 328)
-
- 7.21.6.12 vsnprintf 함수 (p: 329)
-
- 7.21.6.13 vsprintf 함수 (p: 329)
-
- K.3.5.3.8 vfprintf_s 함수 (p: 597)
-
- K.3.5.3.10 vprintf_s 함수 (p: 598-599)
-
- K.3.5.3.12 vsnprintf_s 함수 (p: 600)
-
- K.3.5.3.13 vsprintf_s 함수 (p: 601)
- C99 표준 (ISO/IEC 9899:1999):
-
- 7.19.6.8 vfprintf 함수 (p: 292)
-
- 7.19.6.10 vprintf 함수 (p: 293)
-
- 7.19.6.12 vsnprintf 함수 (p: 294)
-
- 7.19.6.13 vsprintf 함수 (p: 295)
- C89/C90 표준 (ISO/IEC 9899:1990):
-
- 4.9.6.7 vfprintf 함수
-
- 4.9.6.8 vprintf 함수
-
- 4.9.6.9 vsprintf 함수
참고 항목
|
(C95)
(C95)
(C95)
(C11)
(C11)
(C11)
(C11)
|
가변 인수 목록을 사용하여 형식화된 와이드 문자 출력을
stdout
, 파일 스트림
또는 버퍼에 출력 (함수) |
|
(C99)
(C11)
(C11)
(C11)
(C11)
|
형식화된 출력을
stdout
, 파일 스트림 또는 버퍼에 출력
(함수) |
|
(C99)
(C99)
(C99)
(C11)
(C11)
(C11)
|
가변 인수 목록을 사용하여
stdin
, 파일 스트림 또는 버퍼에서
형식화된 입력을 읽음 (함수) |
|
C++ documentation
for
vprintf
,
vfprintf
,
vsprintf
,
vsnprintf
|
|