printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s
|
헤더 파일에 정의됨
<stdio.h>
|
||
| (1) | ||
|
int
printf
(
const
char
*
format, ...
)
;
|
(C99 이전) | |
|
int
printf
(
const
char
*
restrict
format, ...
)
;
|
(C99 이후) | |
| (2) | ||
|
int
fprintf
(
FILE
*
stream,
const
char
*
format, ...
)
;
|
(C99 이전) | |
|
int
fprintf
(
FILE
*
restrict
stream,
const
char
*
restrict
format, ...
)
;
|
(C99 이후) | |
| (3) | ||
|
int
sprintf
(
char
*
buffer,
const
char
*
format, ...
)
;
|
(C99 이전) | |
|
int
sprintf
(
char
*
restrict
buffer,
const
char
*
restrict
format, ...
)
;
|
(C99 이후) | |
|
int
snprintf
(
char
*
restrict
buffer,
size_t
bufsz,
const char * restrict format, ... ) ; |
(4) | (C99 이후) |
|
int
printf_s
(
const
char
*
restrict
format, ...
)
;
|
(5) | (C11 이후) |
|
int
fprintf_s
(
FILE
*
restrict
stream,
const
char
*
restrict
format, ...
)
;
|
(6) | (C11 이후) |
|
int
sprintf_s
(
char
*
restrict
buffer, rsize_t bufsz,
const char * restrict format, ... ) ; |
(7) | (C11 이후) |
|
int
snprintf_s
(
char
*
restrict
buffer, rsize_t bufsz,
const char * restrict format, ... ) ; |
(8) | (C11 이후) |
주어진 위치에서 데이터를 로드하고, 이를 문자 문자열 등가물로 변환한 후 다양한 싱크/스트림에 결과를 기록합니다:
-
-
변환 지정자
%n이 format 에 존재하는 경우 -
%s에 해당하는 인자 중 null pointer가 있는 경우 - stream 이나 format 이나 buffer 가 null pointer인 경우
- bufsz 가 0이거나 RSIZE_MAX 보다 큰 경우
- 문자열 및 문자 변환 지정자에서 인코딩 오류가 발생하는 경우
-
(
sprintf_s에만 해당) buffer 에 저장될 문자열(종료 null 문자 포함)이 bufsz 를 초과하는 경우
-
변환 지정자
-
모든 경계 검사 함수들과 마찬가지로,
printf_s,fprintf_s,sprintf_s,snprintf_s는 구현체가 __STDC_LIB_EXT1__ 를 정의하고 사용자가 <stdio.h> 를 포함하기 전에 __STDC_WANT_LIB_EXT1__ 를 정수 상수 1 로 정의한 경우에만 사용 가능함이 보장됩니다.
목차 |
매개변수
| stream | - | 출력할 파일 스트림 |
| buffer | - | 출력할 문자열을 가리키는 포인터 |
| bufsz | - | 최대 bufsz - 1 개의 문자와 널 종결자를 기록할 수 있음 |
| format | - | 데이터 해석 방법을 지정하는 널 종결 바이트 문자열 포인터 |
| ... | - | 출력할 데이터를 지정하는 인자들. 기본 인자 승격 이후의 인자가 해당 변환 지정자에 기대되는 타입(기대 타입은 승격된 타입이거나 승격된 타입과 호환되는 타입)이 아니거나, format 이 요구하는 것보다 인자가 적으면 동작은 정의되지 않음. format 이 요구하는 것보다 인자가 많으면 초과 인자는 평가된 후 무시됨. |
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 로 변환합니다.
|
해당 없음 | ||||||||
u
|
부호 없는 정수 를 십진법 표현 dddd 로 변환합니다.
|
N/A | ||||||||
f
F
(C99)
|
부동 소수점 숫자 를 [-]ddd.ddd 스타일의 10진수 표기법으로 변환합니다.
|
해당 없음 | 해당 없음 |
double
|
double
(C99)
|
해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 |
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
|
부동 소수점 숫자 를 값과 정밀도 에 따라 10진수 또는 10진수 지수 표기법으로 변환합니다.
|
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
등이
메모리 기록 변환 지정자
각 변환 지정자의 동작 이후에는
시퀀스 포인트
가 있습니다; 이로 인해 여러
변환 지정자가 유효하지 않으면 동작은 정의되지 않습니다. |
||||||||||
반환값
참고 사항
C 표준과
POSIX
는 인자가 대상 버퍼와 겹칠 때
sprintf
와 그 변형 함수들의 동작이 정의되지 않는다고 명시합니다. 예시:
sprintf(dst, "%s and %s", dst, t); // <- broken: undefined behavior
POSIX는
오류 발생 시
errno
가 설정된다고 명시합니다. 또한 추가 변환 지정자를 지정하는데, 가장 주목할 만한 것은 인수 재정렬 지원입니다(
n$
가
%
바로 뒤에 오는 경우
n
번째
인수를 나타냄).
snprintf
함수를
bufsz
를 0으로,
buffer
를 null 포인터로 지정하여 호출하는 것은 출력을 담을 수 있는 필요한 버퍼 크기를 결정하는 데 유용합니다:
snprintf_s
는
snprintf
와 마찬가지로, 그러나
sprintf_s
와는 달리, 출력을
bufsz
-
1
에 맞도록 잘라냅니다.
예제
#include <inttypes.h> #include <stdint.h> #include <stdio.h> int main(void) { const char* s = "Hello"; printf("Strings:\n"); // same as puts("Strings"); printf(" padding:\n"); printf("\t[%10s]\n", s); printf("\t[%-10s]\n", s); printf("\t[%*s]\n", 10, s); printf(" truncating:\n"); printf("\t%.4s\n", s); printf("\t%.*s\n", 3, s); printf("Characters:\t%c %%\n", 'A'); printf("Integers:\n"); printf("\tDecimal:\t%i %d %.6i %i %.0i %+i %i\n", 1, 2, 3, 0, 0, 4,-4); printf("\tHexadecimal:\t%x %x %X %#x\n", 5, 10, 10, 6); printf("\tOctal:\t\t%o %#o %#o\n", 10, 10, 4); printf("Floating-point:\n"); printf("\tRounding:\t%f %.0f %.32f\n", 1.5, 1.5, 1.3); printf("\tPadding:\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5); printf("\tScientific:\t%E %e\n", 1.5, 1.5); printf("\tHexadecimal:\t%a %A\n", 1.5, 1.5); printf("\tSpecial values:\t0/0=%g 1/0=%g\n", 0.0 / 0.0, 1.0 / 0.0); printf("Fixed-width types:\n"); printf("\tLargest 32-bit value is %" PRIu32 " or %#" PRIx32 "\n", UINT32_MAX, UINT32_MAX ); }
가능한 출력:
Strings:
padding:
[ Hello]
[Hello ]
[ Hello]
truncating:
Hell
Hel
Characters: A %
Integers:
Decimal: 1 2 000003 0 +4 -4
Hexadecimal: 5 a A 0x6
Octal: 12 012 04
Floating-point:
Rounding: 1.500000 2 1.30000000000000004440892098500626
Padding: 01.50 1.50 1.50
Scientific: 1.500000E+00 1.500000e+00
Hexadecimal: 0x1.8p+0 0X1.8P+0
Special values: 0/0=-nan 1/0=inf
Fixed-width types:
Largest 32-bit value is 4294967295 or 0xffffffff
참고문헌
- C23 표준 (ISO/IEC 9899:2024):
-
- 7.21.6.1 fprintf 함수 (p: TBD)
-
- 7.21.6.3 printf 함수 (p: TBD)
-
- 7.21.6.5 snprintf 함수 (p: TBD)
-
- 7.21.6.6 sprintf 함수 (p: TBD)
-
- K.3.5.3.1 fprintf_s 함수 (p: TBD)
-
- K.3.5.3.3 printf_s 함수 (p: TBD)
-
- K.3.5.3.5 snprintf_s 함수 (p: TBD)
-
- K.3.5.3.6 sprintf_s 함수 (p: TBD)
- C17 표준 (ISO/IEC 9899:2018):
-
- 7.21.6.1 fprintf 함수 (p: 225-230)
-
- 7.21.6.3 printf 함수 (p: 236)
-
- 7.21.6.5 snprintf 함수 (p: 237)
-
- 7.21.6.6 sprintf 함수 (p: 237)
-
- K.3.5.3.1 fprintf_s 함수 (p: 430)
-
- K.3.5.3.3 printf_s 함수 (p: 432)
-
- K.3.5.3.5 snprintf_s 함수 (p: 432-433)
-
- K.3.5.3.6 sprintf_s 함수 (p: 433)
- C11 표준 (ISO/IEC 9899:2011):
-
- 7.21.6.1 fprintf 함수 (p: 309-316)
-
- 7.21.6.3 printf 함수 (p: 324)
-
- 7.21.6.5 snprintf 함수 (p: 325)
-
- 7.21.6.6 sprintf 함수 (p: 325-326)
-
- K.3.5.3.1 fprintf_s 함수 (p: 591)
-
- K.3.5.3.3 printf_s 함수 (p: 593-594)
-
- K.3.5.3.5 snprintf_s 함수 (p: 594-595)
-
- K.3.5.3.6 sprintf_s 함수 (p: 595-596)
- C99 표준 (ISO/IEC 9899:1999):
-
- 7.19.6.1 fprintf 함수 (p: 274-282)
-
- 7.19.6.3 printf 함수 (p: 290)
-
- 7.19.6.5 snprintf 함수 (p: 290-291)
-
- 7.19.6.6 sprintf 함수 (p: 291)
- C89/C90 표준 (ISO/IEC 9899:1990):
-
- 4.9.6.1 fprintf 함수
-
- 4.9.6.3 printf 함수
-
- 4.9.6.5 sprintf 함수
참고 항목
|
(C95)
(C95)
(C95)
(C11)
(C11)
(C11)
(C11)
|
형식화된 와이드 문자 출력을
stdout
, 파일 스트림 또는 버퍼에 출력
(함수) |
|
(C99)
(C11)
(C11)
(C11)
(C11)
|
가변 인수 목록을 사용하여 형식화된 출력을
stdout
, 파일 스트림 또는 버퍼에 출력
(함수) |
|
문자 문자열을 파일 스트림에 기록
(함수) |
|
|
(C11)
(C11)
(C11)
|
형식화된 입력을
stdin
, 파일 스트림 또는 버퍼에서 읽음
(함수) |
|
C++ documentation
for
printf
,
fprintf
,
sprintf
,
snprintf
|
|