printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s

헤더 `<stdio.h>`
int printf( const char* format, ... );	에 정의됨 (1)	(C99까지)
int printf( const char* restrict format, ... );	에 정의됨 (1)		(C99부터)
int fprintf( FILE* stream, const char* format, ... );	(2)	(C99까지)
int fprintf( FILE* restrict stream, const char* restrict format, ... );	(2)		(C99부터)
int sprintf( char* buffer, const char* format, ... );	(3)	(C99까지)
int sprintf( char* restrict buffer, const char* restrict format, ... );	(3)		(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부터)

주어진 위치에서 데이터를 로드하여 문자열 등가물로 변환하고 결과를 다양한 대상/스트림에 씁니다:

1) 결과를 출력 스트림 stdout에 씁니다.

2) 결과를 출력 스트림 stream에 씁니다.

3) 결과를 문자 문자열 buffer에 씁니다. 쓰여질 문자열(종료 널 문자 포함)이 buffer이 가리키는 배열의 크기를 초과하면 동작은 정의되지 않습니다.

4) 결과를 문자 문자열 buffer에 씁니다. 최대 bufsz - 1 문자가 쓰여집니다. 결과 문자 문자열은 bufsz이 0이 아니면 널 문자로 종료됩니다. bufsz이 0이면 아무 것도 쓰여지지 않으며 buffer은 널 포인터일 수 있지만, 반환 값(널 종결자를 포함하지 않고 쓰여질 바이트 수)은 여전히 계산되어 반환됩니다.

5-8) (1-4)과 동일하지만, 다음 오류가 런타임에 감지되고 현재 설치된 제약 조건 핸들러 함수를 호출한다는 점이 다릅니다:

변환 지정자 %n가 format
에 존재함%s에 해당하는 인수 중 하나가 널 포인터임
stream 또는 format 또는 buffer이 널 포인터임
bufsz이 0이거나 RSIZE_MAX
보다 큼
문자열 및 문자 변환 지정자에서 인코딩 오류 발생sprintf_s( buffer의 경우에만), bufsz에 저장될 문자열(끝 널 포함)이

를 초과함. printf_s모든 경계 검사 함수와 마찬가지로, fprintf_s, sprintf_s, snprintf_s, __STDC_LIB_EXT1__는 구현이 __STDC_WANT_LIB_EXT1__를 정의하고 사용자가 1를 포함하기 전에 <를 정수 상수 >로 정의한 경우에만 사용할 수 있습니다.

매개변수

stream	-	출력 파일 스트림
buffer	-	쓰기 위한 문자 문자열에 대한 포인터
bufsz	-	최대 `bufsz - 1` 문자(널 종결자 제외)를 쓸 수 있음
format	-	데이터 해석 방법을 지정하는 널 종료 바이트 문자열에 대한 포인터
...	-	출력할 데이터를 지정하는 인수. 기본 인수 승격 이후의 인수가 해당 변환 사양에 의해 예상된 유형(예상 유형은 승격된 유형 또는 승격된 유형과 호환되는 유형)이 아니거나, `format`에 필요한 것보다 적은 인수가 있는 경우 동작은 정의되지 않습니다. `format`에 필요한 것보다 많은 인수가 있으면 추가 인수는 평가되고 무시됩니다.

format 문자열은 출력 스트림에 그대로 복사되는 일반 바이트 문자( % 제외)와 변환 사양으로 구성됩니다. 각 변환 사양은 다음 형식을 갖습니다:

도입 % 문자.

(선택사항) 변환의 동작을 수정하는 하나 이상의 플래그:

-: 변환 결과가 필드 내에서 왼쪽 정렬됩니다(기본적으로 오른쪽 정렬).
+: 부호 있는 변환의 부호가 항상 결과 앞에 붙습니다(기본적으로 결과는 음수일 때만 마이너스가 앞에 붙습니다).
공백: 부호 있는 변환 결과가 부호 문자로 시작하지 않거나 비어 있으면 결과 앞에 공백이 붙습니다. + 플래그가 있으면 무시됩니다.
#: 대체 형식의 변환이 수행됩니다. 정확한 효과는 아래 표를 참조하십시오. 그렇지 않으면 동작이 정의되지 않습니다.
0: 정수 및 부동 소수점 숫자 변환의 경우 필드를 채우기 위해 공백 문자 대신 선행 0이 사용됩니다. 정수 숫자의 경우 정밀도가 명시적으로 지정되면 무시됩니다. 이 플래그를 사용하는 다른 변환은 정의되지 않은 동작을 초래합니다. - 플래그가 있으면 무시됩니다.

(선택사항) 최소 필드 너비를 지정하는 정수 값 또는 *. 결과는 필요한 경우 왼쪽 정렬 시 오른쪽에, 오른쪽 정렬 시 왼쪽에 공백 문자로 채워집니다(기본값). *을 사용하면 너비가 변환될 인수와 정밀도가 제공되는 경우 그 앞에 오는 int 유형의 추가 인수로 지정됩니다. 인수 값이 음수이면 - 플래그가 지정되고 양의 필드 너비가 적용됩니다(참고: 이것은 최소 너비입니다. 값이 잘리지 않습니다).

(선택사항) . 뒤에 정수 또는 *이 오거나, 아무것도 오지 않으며 변환의 정밀도를 지정합니다. *을 사용하면 정밀도가 변환될 인수 앞에 오고 최소 필드 너비가 제공되는 경우 그 뒤에 오는 int 유형의 추가 인수로 지정됩니다. 이 인수의 값이 음수이면 무시됩니다. 숫자나 *이 모두 사용되지 않으면 정밀도는 0으로 간주됩니다. 정밀도의 정확한 효과는 아래 표를 참조하십시오.

(선택사항) 길이 수정자는 인수의 크기를 지정합니다(변환 형식 지정자와 함께 해당 인수의 유형을 지정합니다).

변환 형식 지정자.

사용 가능한 형식 지정자는 다음과 같습니다:

변환 지정자	설명	예상 인수 유형
길이 수정자→		hh	h	없음	l	ll	j	z	t	L
C99부터만 가능→		예				예	예	예	예
`%`	리터럴 `%`을 씁니다. 전체 변환 사양은 `%%`이어야 합니다.	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음
`c`	단일 문자를 씁니다. 인수는 먼저 `unsigned char`로 변환됩니다. l 수정자가 사용되면 인수는 먼저 %ls와 `wchar_t[2]` 인수를 사용하여 문자 문자열로 변환됩니다.	해당 없음	해당 없음	`int`	wint_t	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음
`s`	문자 문자열을 씁니다. 인수는 문자 배열의 첫 번째 요소에 대한 포인터여야 합니다. 정밀도는 쓸 최대 바이트 수를 지정합니다. 정밀도가 지정되지 않으면 첫 번째 널 종결자까지(포함하지 않음) 모든 바이트를 씁니다. l 지정자가 사용되면 인수는 `wchar_t` 배열의 첫 번째 요소에 대한 포인터여야 하며, wcrtomb을 0으로 초기화된 변환 상태로 호출한 것처럼 char 배열로 변환됩니다.	해당 없음	해당 없음	`char*`	`wchar_t*`	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음
`d` `i`	부호 있는 정수를 십진수 표현 [-]dddd로 변환합니다. 정밀도는 나타날 최소 자릿수를 지정합니다. 기본 정밀도는 `1`입니다. 변환된 값과 정밀도가 모두 `0`이면 결과는 문자가 없습니다. `z` 수정자의 경우 예상 인수 유형은 size_t의 부호 있는 버전입니다.	`signed char`	`short`	`int`	`long`	`long long`	intmax_t	※	ptrdiff_t	해당 없음
`b` `B` (선택사항) (C23)	부호 없는 정수를 이진수 표현 bbbb로 변환합니다. 정밀도는 나타날 최소 자릿수를 지정합니다. 기본 정밀도는 `1`입니다. 변환된 값과 정밀도가 모두 `0`이면 결과는 문자가 없습니다. 대체 구현 `0b`에서 `0B`는 변환된 값이 0이 아닌 경우 결과 앞에 붙습니다.	`unsigned char`	`unsigned short`	`unsigned int`	`unsigned long`	`unsigned long long`	uintmax_t	size_t	ptrdiff_t	의 부호 없는 버전
`o`	해당 없음부호 없는 정수를 8진수 표현 oooo 로 변환합니다. 정밀도`1`는 나타날 최소 자릿수를 지정합니다. 기본 정밀도는 입니다.`0`변환된 값과 정밀도가 모두 이면 결과는 문자가 없습니다.대체 구현`0`에서 정밀도는 필요한 경우 하나의 선행 0을 쓰기 위해 증가됩니다. 그 경우 변환된 값과 정밀도가 모두 `0`이면 단일									이 쓰여집니다.
`x` `X`	해당 없음부호 없는 정수를 16진수 표현 hhhh 로 변환합니다. `xabcdef` 변환의 경우 문자 가 사용됩니다.`XABCDEF` 변환의 경우 문자 가 사용됩니다.정밀도`1`는 나타날 최소 자릿수를 지정합니다. 기본 정밀도는 입니다.`0`변환된 값과 정밀도가 모두 이면 결과는 문자가 없습니다. `0x`대체 구현`0X`에서									는 변환된 값이 0이 아닌 경우 결과 앞에 붙습니다.
`u`	해당 없음부호 없는 정수를 십진수 표현 dddd 로 변환합니다. 정밀도 는 나타날 최소 자릿수를 지정합니다.`1`기본 정밀도는 입니다.`0`변환된 값과 정밀도가 모두									이면 결과는 문자가 없습니다.
`f` `F` 해당 없음	(C99)부동 소수점 숫자를 [-]ddd.ddd 스타일의 십진수 표기법으로 변환합니다. 정밀도 는 소수점 문자 뒤에 나타날 정확한 자릿수를 지정합니다.`6`기본 정밀도는 입니다.대체 구현 에서 소수점 문자는 뒤에 숫자가 없어도 쓰여집니다.무한대 및 NaN 변환 스타일은 참고	를 참조하십시오.	해당 없음	`double`	`double` 해당 없음	(C99)	해당 없음	해당 없음	해당 없음	`long double`
`e` `E`	해당 없음부동 소수점 숫자 를 십진수 지수 표기법으로 변환합니다. `e` 변환 스타일의 경우 `e`[-]d.ddd±dd 가 사용됩니다.`E` 변환 스타일의 경우 `E`[-]d.ddd±dd 가 사용됩니다. 지수는 최소 두 자리를 포함하며, 필요한 경우에만 더 많은 자리가 사용됩니다.`0`값이 `0`이면 지수도 입니다.정밀도 는 소수점 문자 뒤에 나타날 정확한 자릿수를 지정합니다.`6`기본 정밀도는 입니다.대체 구현 에서 소수점 문자는 뒤에 숫자가 없어도 쓰여집니다.무한대 및 NaN 변환 스타일은 참고	를 참조하십시오.	해당 없음			해당 없음	해당 없음	해당 없음	해당 없음
`a` `A` 해당 없음	(C99)부동 소수점 숫자 를 16진수 지수 표기법으로 변환합니다. `a` 변환 스타일의 경우 `0x`[-] `p`h.hhh±d 가 사용됩니다.`A` 변환 스타일의 경우 `0X`[-] `P`h.hhh±d 가 사용됩니다.`0`첫 번째 16진수는 인수가 정규화된 부동 소수점 값이면 이 아닙니다.`0`값이 `0`이면 지수도 입니다.정밀도 는 16진수 점 문자 뒤에 나타날 정확한 자릿수를 지정합니다. 기본 정밀도는 값의 정확한 표현에 충분합니다.대체 구현 에서 소수점 문자는 뒤에 숫자가 없어도 쓰여집니다.무한대 및 NaN 변환 스타일은 참고	를 참조하십시오.	해당 없음			해당 없음	해당 없음	해당 없음	해당 없음
`g` `G`	해당 없음부동 소수점 숫자를 값과 정밀도 에 따라 십진수 또는 십진수 지수 표기법으로 변환합니다. `ge` 변환 스타일의 경우 `f` 또는 스타일의 변환이 수행됩니다.`GE` 변환 스타일의 경우 `f` 또는 `F`(C99까지)(C99부터) 스타일의 변환이 수행됩니다.`P6`이 0이 아닌 경우 정밀도와 같고, 정밀도가 지정되지 않은 경우 `1`, 정밀도가 `0`이면 `E`라고 합시다. 그러면 `X` 스타일의 변환이 의 지수를 갖는다면: >P X ≥ −4`f`이면, 변환은 `F` 또는 (C99부터) 스타일과 정밀도 P − 1 − X 로 수행됩니다.`e`그렇지 않으면 변환은 `E` 또는 스타일과 정밀도 P − 1 로 수행됩니다.대체 표현 이 요청되지 않으면 후행 0이 제거되고, 소수 부분이 남지 않으면 소수점 문자도 제거됩니다.무한대 및 NaN 변환 스타일은 참고	를 참조하십시오.	해당 없음			해당 없음	해당 없음	해당 없음	해당 없음
`n`	해당 없음이 함수 호출에 의해 지금까지 쓰여진 문자 수 를 반환합니다. 결과는 인수가 가리키는 값에 쓰여집니다. 사양에는 플래그, 필드 너비 또는 정밀도가 포함될 수 없습니다. `z` 수정자의 경우 예상 인수 유형은 `S*`이며, 여기서 `S`는 `size_t`의 부호 있는 버전입니다.	`signed char*`	`short*`	`int*`	`long*`	`long long*`	intmax_t`*`	※	ptrdiff_t`*`	해당 없음
`p`	포인터를 정의하는 구현 정의 문자 시퀀스를 씁니다.	해당 없음	해당 없음	`void*`	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음	해당 없음
참고
부동 소수점 변환 함수는 무한대를 `inf` 또는 `infinity`로 변환합니다. 어느 것이 사용되는지는 구현 정의입니다. NaN은 `nan` 또는 `nan(char_sequence)`로 변환됩니다. 어느 것이 사용되는지는 구현 정의입니다. 변환 `F`, `E`, `G`, `A`은 대신 `INF`, `INFINITY`, `NAN`을 출력합니다. `char`, `unsigned char`, `signed char`, `short`, `unsigned short`를 출력하는 데 사용되는 변환 지정자는 기본 인수 승격의 승격된 유형을 기대하지만, 인쇄하기 전에 그 값은 `char`, `unsigned char`, `signed char`, `short`, `unsigned short`로 변환됩니다. 가변 인수 함수가 호출될 때 발생하는 승격 때문에 이러한 유형의 값을 전달하는 것은 안전합니다. 고정 너비 문자 유형(int8_t 등)에 대한 올바른 변환 사양은 헤더 `<inttypes.h>`에 정의되어 있습니다( PRIdMAX, PRIuMAX 등은 `%jd`, `%ju` 등과 동의어입니다). 메모리 쓰기 변환 지정자 `%n`는 형식 문자열이 사용자 입력에 의존하는 보안 악용의 일반적인 대상이며 경계 검사 `printf_s` 함수 계열에서 지원되지 않습니다(C11부터). 각 변환 지정자 동작 후에 시퀀스 포인트가 있습니다. 이는 여러 `%n` 결과를 동일한 변수에 저장하거나, 경계 사례로, 동일한 호출 내에서 이전 `%n`에 의해 수정된 문자열을 인쇄하는 것을 허용합니다. 변환 사양이 유효하지 않으면 동작이 정의되지 않습니다.

반환 값

1,2) 출력 스트림으로 전송된 문자 수 또는 출력 오류 또는 인코딩 오류(문자열 및 문자 변환 지정자의 경우)가 발생한 경우 음수 값.

3) buffer에 쓰여진 문자 수(종료 널 문자 제외) 또는 인코딩 오류(문자열 및 문자 변환 지정자의 경우)가 발생한 경우 음수 값.

4) buffer이 무시되었다면 bufsz에 쓰여졌을 문자 수(종료 널 문자 포함하지 않음) 또는 인코딩 오류(문자열 및 문자 변환 지정자의 경우)가 발생한 경우 음수 값.

5,6) 출력 스트림으로 전송된 문자 수 또는 출력 오류, 런타임 제약 조건 위반 오류 또는 인코딩 오류가 발생한 경우 음수 값.

7) buffer에 쓰여진 문자 수(널 문자 제외, 단 buffer이 널 포인터가 아니고 bufsz이 0이 아니며 RSIZE_MAX보다 크지 않은 한 항상 쓰여짐) 또는 런타임 제약 조건 위반 시 0, 인코딩 오류 시 음수 값.

8) 종료 널 문자( buffer이 널 포인터가 아니고 bufsz이 0이 아니며 RSIZE_MAX보다 크지 않은 한 항상 쓰여짐)를 포함하지 않고 buffer이 무시되었다면 bufsz에 쓰여졌을 문자 수, 또는 런타임 제약 조건 위반이나 인코딩 오류가 발생한 경우 음수 값.

참고

C 표준과 POSIX는 인수가 대상 버퍼와 겹칠 때 sprintf 및 그 변형의 동작이 정의되지 않는다고 명시합니다. 예:

sprintf(dst, "%s and %s", dst, t); // <- broken: undefined behavior

POSIX는 오류 시 errno가 설정된다고 명시합니다. 또한 추가 변환 사양, 특히 인수 재정렬 지원( n$ 바로 뒤에 %는 n^번째 인수를 나타냄)을 명시합니다.

snprintf을 0 bufsz과 널 포인터 buffer로 호출하는 것은 필요한 버퍼 크기를 결정하여 출력을 포함하는 데 유용합니다:

const char fmt[] = "sqrt(2) = %f";
int sz = snprintf(NULL, 0, fmt, sqrt(2));
char buf[sz + 1]; // note +1 for terminating null byte
snprintf(buf, sizeof buf, fmt, sqrt(2));

snprintf_ssnprintf은 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 The fprintf function (p: TBD)

7.21.6.3 The printf function (p: TBD)

7.21.6.5 The snprintf function (p: TBD)

7.21.6.6 The sprintf function (p: TBD)

K.3.5.3.1 The fprintf_s function (p: TBD)

K.3.5.3.3 The printf_s function (p: TBD)

K.3.5.3.5 The snprintf_s function (p: TBD)

K.3.5.3.6 The sprintf_s function (p: TBD)

C17 표준 (ISO/IEC 9899:2018):

7.21.6.1 The fprintf function (p: 225-230)

7.21.6.3 The printf function (p: 236)

7.21.6.5 The snprintf function (p: 237)

7.21.6.6 The sprintf function (p: 237)

K.3.5.3.1 The fprintf_s function (p: 430)

K.3.5.3.3 The printf_s function (p: 432)

K.3.5.3.5 The snprintf_s function (p: 432-433)

K.3.5.3.6 The sprintf_s function (p: 433)

C11 표준 (ISO/IEC 9899:2011):

7.21.6.1 The fprintf function (p: 309-316)

7.21.6.3 The printf function (p: 324)

7.21.6.5 The snprintf function (p: 325)

7.21.6.6 The sprintf function (p: 325-326)

K.3.5.3.1 The fprintf_s function (p: 591)

K.3.5.3.3 The printf_s function (p: 593-594)

K.3.5.3.5 The snprintf_s function (p: 594-595)

K.3.5.3.6 The sprintf_s function (p: 595-596)

C99 표준 (ISO/IEC 9899:1999):

7.19.6.1 The fprintf function (p: 274-282)

7.19.6.3 The printf function (p: 290)

7.19.6.5 The snprintf function (p: 290-291)

7.19.6.6 The sprintf function (p: 291)

C89/C90 표준 (ISO/IEC 9899:1990):

4.9.6.1 The fprintf function

4.9.6.3 The printf function

4.9.6.5 The sprintf function

같이 보기

wprintffwprintfswprintfwprintf_sfwprintf_sswprintf_ssnwprintf_s (C95)(C95)(C95)(C11)(C11)(C11)(C11)	형식화된 와이드 문자 출력을 stdout, 파일 스트림 또는 버퍼에 인쇄합니다 (함수)
vprintfvfprintfvsprintfvsnprintfvprintf_svfprintf_svsprintf_svsnprintf_s (C99)(C11)(C11)(C11)(C11)	가변 인수 목록을 사용하여 형식화된 출력을 stdout, 파일 스트림 또는 버퍼에 인쇄합니다 (함수) fputs
파일 스트림에 문자 문자열을 씁니다	(함수) scanf
fscanfsscanfscanf_sfscanf_ssscanf_s(C11) (C11)(C11)형식화된 입력을	stdin, 파일 스트림 또는 버퍼에서 읽습니다(함수) C++ 문서
for printf, fprintf, sprintf, snprintf

컴파일러 지원
언어
헤더
타입 지원
프로그램 유틸리티
가변 인수 함수 지원
오류 처리
동적 메모리 관리
문자열 라이브러리
알고리즘
수치 연산
날짜 및 시간 유틸리티
입출력 지원
지역화 지원
동시성 지원 (C11)
기술 사양
기호 색인

ko.cppreference.net

Namespaces

Variants

printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s

목차

매개변수

반환 값

참고

예제

참조

같이 보기