PHP sprintf(): Dizge Biçimlendirme, Doldurma ve Ondalıklar

sprintf() bir biçimden ve bir değer listesinden oluşturulmuş bir dizge döndürür: biçimdeki her % yer tutucusu sıradaki değerle değiştirilir. sprintf('%s is %d years old', 'Ada', 36) "Ada is 36 years old" döndürür. printf() aynı argümanları alır ama sonucu döndürmek yerine yazdırır.

<?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);

Yer tutucular soldan sağa sırayla doldurulur. %.2f her zaman iki ondalık gösterir (4.5 değil 4.50) ve %05d sayıyı sıfırlarla beş basamağa tamamlar.

Biçim belirteçleri

Bir yer tutucu %, isteğe bağlı değiştiriciler ve tür için tek bir harften oluşur:

Aşağıdaki değerleri değiştirin ve tekrar çalıştırın:

<?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 bir ondalıklı sayıyı sıfıra doğru keser, bu yüzden 42.9 42 olur. 43 istiyorsanız önce yuvarlayın: sprintf('%d', round(42.9)). 'abc' gibi sayı olmayan bir dizge %d altında 0 olur.

Baştaki sıfırlarla doldurma

% ile harf arasına bir doldurma karakteri ve bir genişlik koyabilirsiniz. %05d "5 genişliğe kadar 0 ile doldur" demektir. Sipariş numaralarını, fatura numaralarını, saatleri ve tarihleri biçimlendirmenin olağan yolu budur.

<?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";

Genişlik bir alt sınırdır. Genişlikten uzun bir sayı tam olarak yazdırılır.

%05.2f: genişlik ve ondalıklar birlikte

Ondalıklı sayılarda genişlik, ondalık nokta ve eksi işareti dahil sonucun her karakterini sayar. %05.2f biçiminin 3.14159 için 03.14 vermesinin nedeni budur: toplam beş karakter, ikisi noktadan sonra.

<?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 geçerli yerel ayarın (setlocale() ile ayarlanan) ondalık ayırıcısını kullanır, %F ise her zaman nokta kullanır. Kodunuz bir yerel ayar belirliyorsa ve JSON, CSV veya bir API için noktaya ihtiyacınız varsa %F kullanın.

Metni sütunlarda hizalama

Pozitif bir genişlik sağa hizalar, genişlikten önceki bir - sola hizalar ve ' ardından gelen bir karakter özel bir doldurma karakteri belirler. Birlikte düz metin raporlarını ve fişleri hizalarlar.

<?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 ürün adını sağdan 14 karaktere doldurur, %8.2f fiyatı 8 karakterde sağa hizalar ve boş bir dizgeyle %'-27s 27 tirelik bir çizgi yazdırır. %'*10s boşluk yerine * ile doldurur.

Argümanları yeniden kullanmak veya sıralamak için numaralandırma

%1$s "dizge olarak ilk argüman", %2$d "tam sayı olarak ikinci argüman" demektir. Numaralandırılmış yer tutucular bir değeri iki kez kullanmanıza ya da argüman listesini değiştirmeden sırayı değiştirmenize izin verir; diller arasında kelime sırası farklı olduğunda çevirmenlerin ihtiyaç duyduğu budur.

<?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 ve dönüş değerleri

vsprintf() değerleri tek bir dizi olarak alır; değerler zaten bir dizide durduğunda kullanışlıdır. printf() yazdırdığı bayt sayısını döndürür ve vprintf(), printf() fonksiyonunun dizi sürümüdür.

<?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() sayısına yeni satır dahildir, bu yüzden "Hello\n" 6 bayttır. Çok baytlı metinlerde karakterleri değil baytları sayar.

Az argüman hata fırlatır

PHP 8'den beri değerlerden fazla yer tutucu içeren bir biçim false döndürmek yerine bir ArgumentCountError fırlatır. Bu hatayı gördüğünüzde % yer tutucularını (%% hariç) sayın.

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

Mesaj biçim dizgesini de bir argüman olarak sayar: ArgumentCountError: 4 arguments are required, 3 given. Fazla argümanlar sessizce yok sayılır, bu yüzden ters hata bir hata olarak görünmez. Bir sprintf sonucu yanlış görünüyorsa biçimi değerlerin yanında yazdırın. Tek ihtiyacınız bir binlik ayırıcıysa number_format() onu sprintf ile kurmaktan daha basittir. Değiştiricilerin tam listesi php.net üzerinde.