std:: vwprintf, std:: vfwprintf, std:: vswprintf
|
헤더 파일에 정의됨
<cwchar>
|
||
|
int
vwprintf
(
const
wchar_t
*
format,
va_list
vlist
)
;
|
(1) | |
|
int
vfwprintf
(
std::
FILE
*
stream,
const
wchar_t
*
format,
va_list
vlist
)
;
|
(2) | |
|
int
vswprintf
(
wchar_t
*
buffer,
std::
size_t
buf_size,
const
wchar_t
*
format,
va_list
vlist
)
;
|
(3) | |
vlist
로 정의된 위치에서 데이터를 로드하고, 이를 와이드 문자열 등가물로 변환한 후 다양한 싱크에 결과를 기록합니다.
stream
에 기록합니다.
buffer
에 기록합니다. 최대
size
-
1
개의 와이드 문자 뒤에 널 와이드 문자가 기록됩니다.
목차 |
매개변수
| stream | - | 출력할 와이드 스트림 |
| buffer | - | 출력할 와이드 문자열에 대한 포인터 |
| buf_size | - | 최대 출력 와이드 문자 수 |
| format | - | 데이터 해석 방법을 지정하는 널 종료 와이드 문자열에 대한 포인터 |
| vlist | - | variable argument list 출력할 데이터를 포함하는 가변 인수 목록. |
format
문자열은 출력 스트림에 변경 없이 복사되는 일반 와이드 문자(
%
제외)와 변환 지정자로 구성됩니다. 각 변환 지정자는 다음 형식을 가집니다:
-
-
서론적인
%문자입니다.
-
서론적인
-
- (선택 사항) 변환 동작을 수정하는 하나 이상의 플래그:
-
-
-: 변환 결과가 필드 내에서 왼쪽 정렬됩니다 (기본값은 오른쪽 정렬). -
+: 부호 있는 변환의 경우 결과 앞에 항상 부호가 붙습니다 (기본적으로는 결과가 음수일 때만 마이너스 부호가 붙음). -
space
: 부호 있는 변환 결과가 부호 문자로 시작하지 않거나 비어 있는 경우, 결과 앞에 공백이 추가됩니다.
+플래그가 존재할 경우 무시됩니다. -
#: 변환의 대체 형태 가 수행됩니다. 정확한 효과는 아래 표를 참조하십시오. 그렇지 않을 경우 동작은 정의되지 않습니다. -
0: 정수 및 부동 소수점 숫자 변환의 경우, space 문자 대신 선행 영(0)이 필드 채우기에 사용됩니다. 정수 숫자의 경우 명시적으로 정밀도가 지정되면 무시됩니다. 다른 변환에서 이 플래그를 사용하면 동작이 정의되지 않습니다.-플래그가 존재할 경우 무시됩니다.
-
-
-
(선택 사항)
최소 필드 너비를 지정하는 정수 값 또는
*. 필요한 경우 결과는 오른쪽 정렬 시 왼쪽에, 왼쪽 정렬 시 오른쪽에 (기본적으로) 공백 문자로 채워집니다.*가 사용되는 경우, 너비는 int 타입의 추가 인수로 지정되며, 이 인수는 변환할 인수와 정밀도를 제공하는 인수(있는 경우) 앞에 나타납니다. 인수 값이 음수인 경우-플래그가 지정되고 양의 필드 너비가 적용됩니다 (참고: 이는 최소 너비이며 값은 절대 잘리지 않습니다.).
-
(선택 사항)
최소 필드 너비를 지정하는 정수 값 또는
-
-
(선택 사항)
.뒤에 정수 숫자나*, 또는 아무것도 오지 않을 수 있으며, 이것은 변환의 정밀도 를 지정합니다.*가 사용되는 경우, 정밀도 는 int 타입의 추가 인수로 지정되며, 이 인수는 변환될 인수 앞에 나타나지만, 최소 필드 너비를 공급하는 인수가 제공된 경우 그 뒤에 옵니다. 이 인수의 값이 음수이면 무시됩니다. 숫자나*가 사용되지 않으면 정밀도는 0으로 간주됩니다. 정밀도의 정확한 효과에 대해서는 아래 표를 참조하십시오.
-
(선택 사항)
-
- (선택 사항) 길이 수정자 는 인수의 크기를 지정합니다 (변환 형식 지정자와 결합하여 해당 인수의 유형을 지정합니다).
-
- 변환 형식 지정자.
다음 형식 지정자를 사용할 수 있습니다:
|
변환
지정자 |
설명 |
예상
인수 유형 |
||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 길이 수정자→ | hh | h | 없음 | l | ll | j | z | t | L | |
| C++11부터만 사용 가능→ | Yes | Yes | Yes | Yes | Yes | |||||
%
|
리터럴
%
를 출력합니다. 전체 변환 지정자는
%%
이어야 합니다.
|
N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
c
|
단일 문자 를 기록합니다.
|
N/A | N/A |
int
|
std::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
|
std::ptrdiff_t
의 부호 없는 버전
|
N/A | ||
x
X
|
부호 없는 정수 를 16진수 표현 hhhh 로 변환합니다.
|
N/A | ||||||||
u
|
부호 없는 정수 를 10진수 표현 dddd 로 변환합니다.
|
N/A | ||||||||
f
F
(C++11)
|
부동소수점 숫자 를 [-]ddd.ddd 스타일의 10진수 표기법으로 변환합니다.
|
N/A | N/A |
double
|
double
(C++11)
|
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
(C++11) |
부동소수점 숫자 를 16진수 지수 표기법으로 변환합니다.
|
해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | |||
g
G
|
부동 소수점 숫자 를 값과 정밀도 에 따라 십진수 또는 십진수 지수 표기법으로 변환합니다.
|
해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | 해당 없음 | |||
n
|
이 함수 호출로 지금까지 기록된 문자 수 를 반환합니다.
|
signed
char
*
|
short
*
|
int
*
|
long
*
|
long
long
*
|
※
|
N/A | ||
p
|
구현 정의된 문자 시퀀스를 작성하여 pointer 를 정의합니다. |
N/A | N/A |
void
*
|
N/A | N/A | N/A | N/A | N/A | N/A |
| 참고 사항 | ||||||||||
|
부동 소수점 변환 함수는 무한대를
숫자가 아닌 값(Not-a-number)은
char , unsigned char , signed char , short , 그리고 unsigned short 를 출력하는 데 사용되는 변환 지정자는 기본 인수 승격 의 승격된 타입을 기대하지만, 값을 출력하기 전에 char , unsigned char , signed char , short , 그리고 unsigned short 로 변환됩니다. 가변 인수 함수가 호출될 때 발생하는 승격으로 인해 이러한 타입의 값을 전달하는 것은 안전합니다.
고정 너비 문자 타입(
std::int8_t
등)에 대한 올바른 변환 지정자는 헤더
<cinttypes>
에 정의되어 있습니다(비록
PRIdMAX
,
PRIuMAX
등이
메모리 쓰기 변환 지정자
각 변환 지정자의 동작 이후에는
시퀀스 포인트
가 있습니다; 이는 여러
변환 지정자가 유효하지 않으면 동작은 정의되지 않습니다. |
||||||||||
반환값
size
보다 크거나 같은 경우 음수 값.
참고 사항
좁은 문자열은 필요한 출력 버퍼 크기를 결정할 수 있게 해주는
std::vsnprintf
를 제공하지만, 와이드 문자열에 대해서는 이에 상응하는 기능이 없으며, 버퍼 크기를 결정하기 위해 프로그램은
std::vswprintf
를 호출하고 결과 값을 확인한 후 더 큰 버퍼를 재할당하여 성공할 때까지 다시 시도해야 할 수 있습니다.
예제
|
이 섹션은 불완전합니다
이유: 예제가 없음 |
참고 항목
|
가변 인자 목록을 사용하여 서식이 지정된 출력을
stdout
, 파일 스트림 또는 버퍼에 출력
(함수) |
|
|
서식이 지정된 와이드 문자 출력을
stdout
, 파일 스트림 또는 버퍼에 출력
(함수) |
|
|
C documentation
for
vwprintf
,
vfwprintf
,
vswprintf
|
|