PHP sprintf(): 문자열 포맷, 0 채우기, 소수점

sprintf()는 포맷과 값 목록으로 만든 문자열을 반환합니다. 포맷의 각 % 자리 표시자가 다음 값으로 바뀝니다. sprintf('%s is %d years old', 'Ada', 36)는 "Ada is 36 years old"를 반환합니다. printf()는 같은 인수를 받지만 결과를 반환하는 대신 출력합니다.

<?php
$name = 'Ada';
$age = 36;
$price = 4.5;

$line = sprintf('%s is %d years old', $name, $age);
echo $line, "\n";

// Two decimals, always
echo sprintf('Total: %.2f EUR', $price), "\n";

// printf prints directly
printf("Order #%05d for %s\n", 42, $name);

자리 표시자는 왼쪽에서 오른쪽으로 차례로 채워집니다. %.2f는 항상 소수점 두 자리를 보여 주고(4.5가 아니라 4.50), %05d는 숫자를 0으로 채워 다섯 자리로 만듭니다.

포맷 지정자

자리 표시자는 %, 선택적인 수식어, 그리고 타입을 나타내는 문자 하나로 이루어집니다.

아래 값을 바꾸고 다시 실행해 보세요.

<?php
echo sprintf('%s', 'PHP'), "\n";
echo sprintf('%d', 42.9), "\n";      // the decimals are cut off, not rounded
echo sprintf('%f', 1.5), "\n";
echo sprintf('%.2f', 1.5), "\n";
echo sprintf('%e', 1234.5678), "\n";
echo sprintf('%x %X', 255, 255), "\n";
echo sprintf('%o', 8), "\n";
echo sprintf('%b', 5), "\n";
echo sprintf('%08b', 5), "\n";       // binary padded to 8 bits
echo sprintf('%c', 65), "\n";
echo sprintf('%d%%', 50), "\n";
echo sprintf('%+d %+d', 5, -5), "\n"; // always show the sign

%d는 실수를 0 쪽으로 버리므로 42.9는 42가 됩니다. 43을 원한다면 먼저 반올림하세요: sprintf('%d', round(42.9)). 'abc'처럼 숫자가 아닌 문자열은 %d에서 0이 됩니다.

앞자리를 0으로 채우기

%와 문자 사이에 채울 문자와 폭을 넣을 수 있습니다. %05d는 "0으로 채워 폭 5로"를 뜻합니다. 주문 번호, 송장 ID, 시간, 날짜를 포맷하는 일반적인 방법입니다.

<?php
echo sprintf('%05d', 42), "\n";         // 00042
echo sprintf('%03d', 7), "\n";          // 007
echo sprintf('INV-%06d', 1234), "\n";   // INV-001234

// Times and dates from numbers
$h = 9; $m = 5; $s = 3;
echo sprintf('%02d:%02d:%02d', $h, $m, $s), "\n";
echo sprintf('%04d-%02d-%02d', 2026, 3, 14), "\n";

// A width smaller than the number never cuts it
echo sprintf('%03d', 123456), "\n";

폭은 최솟값입니다. 폭보다 긴 숫자는 전부 출력됩니다.

%05.2f: 폭과 소수점을 함께

실수에서 폭은 소수점과 마이너스 기호를 포함한 결과의 모든 문자를 셉니다. 그래서 3.14159에 %05.2f를 쓰면 03.14가 됩니다. 전체 다섯 글자이고 그중 두 자리가 소수점 뒤입니다.

<?php
$pi = 3.14159;

echo sprintf('%05.2f', $pi), "\n";   // 5 characters in total
echo sprintf('%08.2f', $pi), "\n";   // 8 characters in total
echo sprintf('%.2f', $pi), "\n";     // no width, just 2 decimals
echo sprintf('%.0f', $pi), "\n";     // no decimals
echo sprintf('%.2f', 5), "\n";       // integers get decimals too
echo sprintf('%08.2f', -3.5), "\n";  // the minus sign counts

%f는 setlocale()로 설정한 현재 로케일의 소수점 기호를 쓰고, %F는 항상 점을 씁니다. 코드에서 로케일을 설정하는데 JSON, CSV, API용으로 점이 필요하다면 %F를 쓰세요.

텍스트를 열에 맞춰 정렬하기

양수 폭은 오른쪽 정렬, 폭 앞의 -는 왼쪽 정렬이며, ' 뒤에 문자를 쓰면 채울 문자를 직접 정합니다. 이를 조합하면 일반 텍스트 보고서와 영수증을 정렬할 수 있습니다.

<?php
$items = [
    ['Coffee', 2, 3.5],
    ['Croissant', 1, 2.25],
    ['Orange juice', 3, 4],
];

printf("%-14s %3s %8s\n", 'Item', 'Qty', 'Price');
printf("%'-27s\n", '');

$total = 0;
foreach ($items as [$name, $qty, $price]) {
    $line = $qty * $price;
    $total += $line;
    printf("%-14s %3d %8.2f\n", $name, $qty, $line);
}

printf("%'-27s\n", '');
printf("%-14s %12.2f\n", 'Total', $total);
printf("[%'*10s]\n", 'stars');

%-14s는 상품명을 오른쪽에 채워 14자로 만들고, %8.2f는 가격을 8자 안에 오른쪽 정렬하며, 빈 문자열과 함께 쓴 %'-27s는 대시 27개로 된 선을 출력합니다. %'*10s는 공백 대신 *로 채웁니다.

인수에 번호를 붙여 재사용하거나 순서 바꾸기

%1$s는 "첫 번째 인수를 문자열로", %2$d는 "두 번째 인수를 정수로"를 뜻합니다. 번호를 붙인 자리 표시자를 쓰면 인수 목록을 바꾸지 않고도 값을 두 번 쓰거나 순서를 바꿀 수 있으며, 언어마다 어순이 다를 때 번역자에게 필요합니다.

<?php
// Single quotes: in double quotes PHP would read $s as a variable
$format = '%1$s has %2$d new messages. Open them, %1$s?';
echo sprintf($format, 'Ada', 3), "\n";

// Same arguments, different order in the sentence
$en = 'Page %1$d of %2$d';
$ja = '全%2$dページ中%1$dページ目';
echo sprintf($en, 2, 10), "\n";
echo sprintf($ja, 2, 10), "\n";

// Modifiers go after the $
echo sprintf('%1$05.1f / %1$.3f', 2.71828), "\n";

vsprintf, printf와 반환값

vsprintf()는 값을 배열 하나로 받으므로 값이 이미 배열에 있을 때 편리합니다. printf()는 출력한 바이트 수를 반환하고, vprintf()는 printf()의 배열 버전입니다.

<?php
$row = ['Ada', 'Lovelace', 1815];
echo vsprintf("%s %s was born in %d.\n", $row);

$bytes = printf("%s\n", 'Hello');
echo "printf printed $bytes bytes\n";

// Same result, two ways
echo sprintf('%.1f%%', 12.345), "\n";
printf("%.1f%%\n", 12.345);

printf()의 개수에는 줄바꿈이 포함되므로 "Hello\n"은 6바이트입니다. 멀티바이트 텍스트에서는 문자가 아니라 바이트를 셉니다.

인수가 부족하면 에러

PHP 8부터는 값보다 자리 표시자가 많은 포맷이 false를 반환하는 대신 ArgumentCountError를 던집니다. 이 에러를 보면 % 자리 표시자의 개수를 세어 보세요(%%는 제외).

<?php
// This throws an ArgumentCountError on purpose: 3 placeholders, 2 values
echo sprintf('%s bought %d items for %.2f', 'Ada', 3);

메시지는 포맷 문자열도 인수로 셉니다: ArgumentCountError: 4 arguments are required, 3 given. 남는 인수는 조용히 무시되므로 반대 실수는 에러로 드러나지 않습니다. sprintf 결과가 이상해 보이면 포맷과 값을 나란히 출력해 보세요. 천 단위 구분 기호만 필요하다면 sprintf로 만드는 것보다 number_format()이 더 간단합니다. 전체 수식어 목록은 php.net에 있습니다.