Strings fprintf

(PHP 5, PHP 7, PHP 8)

fprintf — 스트림에 형식이 지정된 문자열 쓰기


설명

fprintf(resource $stream, string $format, mixed ...$values): int

stream이 지정한 스트림 리소스에 format에 따라 생성된 문자열을 씁니다.


매개변수

stream
일반적으로 fopen()을 사용하여 생성되는 파일 시스템 포인터 리소스입니다.
format
형식 문자열은 결과 및 변환 사양에 직접 복사되는 일반 문자(% 제외)와 같은 0개 이상의 지시문으로 구성되며, 각각은 자체 매개변수를 가져옵니다.

변환 사양은 %[argnum$][flags][width][.precision]specifier 프로토타입을 따릅니다.

Argnum

변환에서 처리할 숫자 인수를 지정하기 위해 달러 기호 $가 뒤따르는 정수입니다.

Flags

Flag 설명
- 주어진 필드 너비 내에서 왼쪽 정렬. 오른쪽 맞춤이 기본값입니다.
+ 플러스 기호로 양수 접두사 +; 기본적으로 음수에만 음수 기호가 접두사로 붙습니다.
(space) 결과를 공백으로 채웁니다. 이것이 기본값입니다.
0 0이 있는 숫자만 왼쪽으로 채웁니다. s 지정자를 사용하면 0으로 오른쪽 채울 수도 있습니다.
'(char) 결과를 문자(char)로 채웁니다.
Width

이 변환의 결과로 생성되어야 하는 문자 수(최소)를 나타내는 정수입니다.

Precision

기간 . 그 뒤에 의미가 지정자에 따라 달라지는 정수가 옵니다.

  • e, E, fF 지정자의 경우: 소수점 뒤에 인쇄할 자릿수입니다(기본값은 6).
  • g, G, hH 지정자의 경우 인쇄할 최대 유효 자릿수입니다.
  • s 지정자의 경우: 문자열에 대한 최대 문자 제한을 설정하는 컷오프 포인트 역할을 합니다.

참고: 정밀도에 대한 명시적 값 없이 기간을 지정하면 0으로 간주됩니다.

참고: PHP_INT_MAX보다 큰 위치 지정자를 사용하려고 하면 경고가 생성됩니다.

Specifiers

Specifier 설명
% 리터럴 백분율 문자입니다. 인수가 필요하지 않습니다.
b 인수는 정수로 처리되고 이진수로 표시됩니다.
c 인수는 정수로 처리되고 해당 ASCII가 있는 문자로 표시됩니다.
d 인수는 정수로 처리되고 (부호 있는) 십진수로 표시됩니다.
e 인수는 과학적 표기법으로 처리됩니다(예: 1.2e+2).
E e 지정자와 비슷하지만 대문자를 사용합니다(예: 1.2E+2).
f 인수는 부동 소수점으로 처리되고 부동 소수점 숫자(로케일 인식)로 표시됩니다.
F 인수는 부동 소수점으로 처리되고 부동 소수점 숫자(로케일을 인식하지 않음)로 표시됩니다.
g 일반 형식.

0이 아닌 경우 P를 정밀도와 같게 하고 정밀도가 생략된 경우 6, 정밀도가 0인 경우 1로 설정합니다. 그런 다음 스타일 E를 사용한 변환의 지수가 X인 경우:

P > X ≥ −4인 경우 변환은 스타일 f 및 정밀도 P − (X + 1)로 수행됩니다. 그렇지 않으면 변환은 스타일 e 및 정밀도 P − 1로 수행됩니다.

G g 지정자와 비슷하지만 Ef를 사용합니다.
h g 지정자와 비슷하지만 F를 사용합니다. PHP 8.0.0부터 사용 가능합니다.
H g 지정자와 비슷하지만 EF를 사용합니다. PHP 8.0.0부터 사용 가능합니다.
o 인수는 정수로 처리되고 8진수로 표시됩니다.
s 인수는 문자열로 처리되고 표시됩니다.
u 인수는 정수로 처리되고 부호 없는 십진수로 표시됩니다.
x 인수는 정수로 처리되고 16진수(소문자 포함)로 표시됩니다.
X 인수는 정수로 처리되고 16진수(대문자 포함)로 표시됩니다.

경고 c 유형 지정자는 패딩 및 너비를 무시합니다.

경고 문자당 1바이트 이상이 필요한 문자 집합과 함께 문자열 및 너비 지정자의 조합을 사용하려고 하면 예기치 않은 결과가 발생할 수 있습니다.

변수는 지정자에 적합한 유형으로 강제 변환됩니다.

Type Handling

Type Specifiers
string s
int d, u, c, o, x, X, b
float e, E, f, F, g, G, h, H
values

반환 값

쓰여진 문자열의 길이를 반환합니다.


Examples

예제 #1 fprintf(): 0으로 채워진 정수

                  
<?php
if (!($fp = fopen('date.txt', 'w'))) {
    return;
}

fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
// will write the formatted ISO date to date.txt
?>
                  
                

예제 #2 fprintf(): formatting currency

                  
<?php
if (!($fp = fopen('currency.txt', 'w'))) {
    return;
}

$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;
// echo $money will output "123.1";
$len = fprintf($fp, '%01.2f', $money);
// will write "123.10" to currency.txt

echo "wrote $len bytes to currency.txt";
// use the return value of fprintf to determine how many bytes we wrote
?>
                  
                

기타

  • printf() - 형식이 지정된 문자열 출력
  • sprintf() - 형식이 지정된 문자열 반환
  • vprintf() - 형식이 지정된 문자열 출력
  • vsprintf() - 형식이 지정된 문자열 반환
  • vfprintf() - 스트림에 형식이 지정된 문자열 쓰기
  • sscanf() - 형식에 따라 문자열의 입력을 구문 분석합니다.
  • fscanf() - 형식에 따라 파일에서 입력을 구문 분석
  • number_format() - 그룹화된 천 단위로 숫자 서식 지정
  • date() - Unix 타임스탬프 형식 지정