sprintf

    (PHP 4, PHP 5, PHP 7, PHP 8)

    sprintf — Biçemli bir dizge döndürür

    Açıklama

    sprintf(string$biçem, mixed...$değerler): string

    biçem dizgesiyle biçemlenerek üretilmiş bir dizge döndürür.

    Bağımsız Değişkenler

    biçem

    Biçem dizgesi sıfır veya daha fazla yönergeden oluşur: doğrudan sonuca kopyalanmış sıradan karakterler (% hariç) ve dönüşüm belirtimleri, her biri kendi bağımsız değişkeninin getirilmesiyle sonuçlanır.

    Bir dönüşüm belirtiminin sözdizimi: %[degnum$][seçenekler][genişlik][.hassasiyet]belirteç.

    degnum

    Ardına bir dolar imi $ konmuş bir tamsayı; dönüşümde ele alınacak bağımsız değişken sayısını belirler.

    seçenekler
    SeçenekAçıklama
    - Verilen alan genişliğinde sola dayalı; Sağa dayalılık öntanımlıdır.
    + Pozitif sayıların önüne artı imi konur; Öntanımlı olarak sadece negatif sayılara eksi imi konur.
    (boşluk) Sonuca boşluklarla dolgu yapar. Bu öntanımlıdır.
    0 Sayılar sadece soldan sıfırla doldurulur. s belirteçleri ile sağ taraf da sıfırla doldurulur.
    '(krk) Sonuca (krk) karakteri ile dolgu yapılır.

    genişlik

    Bu dönüşümün kaç karakterle sonuçlanacağının belirtildiği tamsayı veya *. * kullanılmışsa, genişlik, belirtici tarafından biçimlendirilmiş değerden önce ek bir tamsayı değeri olarak sağlanır.

    hassasiyet

    Bir nokta . ve ardından anlamı belirtece bağlı olan seçimlik bir tamsayı veya *:

    • e, E, f ve F belirteçleri için: ondalık noktadan sonra yazdırılacak rakam sayısı (6 öntanımlıdır)
    • g ve G, h ve H belirteçleri için: yazdırılacak maksimum anlamlı basamak sayısı.
    • s belirteci için: dizeye azami karakter sınırı koyan bir kesme noktası gibi davranır.

    Bilginize: Nokta, hassasiyet için açık bir değer olmadan belirtilirse, 0 varsayılır. * kullanılmışsa, genişlik, belirtici tarafından biçimlendirilmiş değerden önce ek bir tamsayı değeri olarak sağlanır.

    Belirteçler
    BelirteçAçıklama
    % Yüzde karakteri. Değer gerekmez.
    b Değer bir tamsayı olarak ele alınır ve ikil bir sayı olarak gösterilir.
    c Değer bir tamsayı olarak ele alınır ve ASCII bir karakter olarak gösterilir.
    d Değer bir tamsayı olarak ele alınır ve (işaretli) bir ondalık sayı olarak gösterilir.
    e Değer bilimsel bir gösterim (örn. 1.2e+2) olarak ele alınır. Hassasiyet belirteci,ondalık noktadan sonraki basamakların sayısını ifade eder.
    Ee belirteci gibi, farklı olarak büyük harf kullanır (örn. 1.2E+2).
    f Değer kayan noktalı sayı olarak ele alınır ve kayan noktalı sayı olarak gösterilir (yerele uygun).
    F Değer kayan noktalı sayı olarak ele alınır ve kayan noktalı sayı olarak gösterilir (yerele bakmaz) PHP 5.0.3 ve sonrasında kullanılabilir.
    g

    Genel biçem.

    P sıfırdan farklı hassasiyet olsun, hassasiyet verilmemişse 6, hassasiyet sıfır ise 1 olsun. E tarzındaki dönüşümün üssü X ise:

    P > X ≥ −4 ise, dönüşüm f tarzı ve hassasiyet P − (X + 1) olur. Aksi takdirde, dönüşüm e tarzı ve hassasiyet P − 1 olur.

    Gg gibidir fakat E ve f kullanır.
    hg gibidir fakat F kullanır. PHP 8.0.0 ve sonrasında kullanılabilir.
    Hggibidir fakat E ve F kullanır. PHP 8.0.0 ve sonrasında kullanılabilir.
    o Değer bir tamsayı olarak ele alınır ve sekizlik bir sayı olarak gösterilir.
    s Değer bir dizge olarak ele alınır ve gösterilir.
    u Değer bir tamsayı olarak ele alınır ve işaretsiz bir ondalık sayı olarak gösterilir.
    x Değer bir tamsayı olarak ele alınır ve onaltılık bir sayı olarak gösterilir (küçük harfli).
    X Değer bir tamsayı olarak ele alınır ve onaltılık bir sayı olarak gösterilir (büyük harfli).
    Uyarı

    c tür belirteci dolguyu ve genişliği yoksayar.

    Uyarı

    Karakter başına birden fazla bayt gerektiren karakter kümeleriyle dizge ve genişlik belirteçlerini bir arada kullanmaya çalışmak, beklenmeyen sonuçlar verebilir

    Değişkenler, belirteç için uygun bir türe zorlanacaktır:

    Tür Yönetimi
    TürBelirteçler
    strings
    intd, u, c, o, x, X, b
    doublee, E, f, F, g, G, h, H
    değerler

    Dönen Değerler

    biçem dizgesine göre biçemlendirilerek üretilen bir dizge döner.

    Hatalar/İstisnalar

    PHP 8.0.0 ve sonrasında, bağımsız değişken sayısı sıfırsa ValueError oluşuyor. PHP 8.0.0 öncesinde bunun yerine bir E_WARNING uyarısı verilirdi.

    PHP 8.0.0 ve sonrasında, [width] (genişlik) sıfırdan küçükse veya PHP_INT_MAX'tan büyükse bir ValueError oluşuyor. PHP 8.0.0 öncesinde, bir E_WARNING uyarısı verilirdi.

    PHP 8.0.0 ve sonrasında, [precision] (hassasiyet) sıfırdan küçükse veya PHP_INT_MAX'tan büyükse bir ValueError oluşuyor. PHP 8.0.0 öncesinde, bir E_WARNING uyarısı verilirdi.

    PHP 8.0.0 ve sonrasında, gereğinden daha az bağımsız değişken verildiğinde bir ArgumentCountError oluşuyor. PHP 8.0.0 öncesinde, bir E_WARNING uyarısı verilirdi.

    Sürüm Bilgisi

    Sürüm: Açıklama
    8.0.0 Bu işlev başarısızlık durumunda artık false döndürmüyor.
    8.0.0 Bağımsız değişken sayısı sıfırsa ValueError oluşuyor. Evvelce bunun yerine bir E_WARNING uyarısı verilirdi.
    8.0.0[width] (genişlik) sıfırdan küçükse veya PHP_INT_MAX'tan büyükse bir ValueError oluşuyor; evvelce bir E_WARNING uyarısı verilirdi.
    8.0.0[precision] (hassasiyet) sıfırdan küçükse veya PHP_INT_MAX'tan büyükse bir ValueError oluşuyor; evvelce bir E_WARNING uyarısı verilirdi.
    8.0.0 Gereğinden daha az bağımsız değişken verildiğinde bir ArgumentCountError oluşuyor; evvelce bir E_WARNING uyarısı verilirdi.

    Örnekler

    Örnek 1 - Bağımsız değişken takaslama

    Biçem dizgesi bağımsız değişken numaralama/takaslama destekliyor.

    <?php
    $num     = 5;
    $location = 'tree';

    $format = 'There are %d monkeys in the %s';
    echo     sprintf($format, $num, $location);
    ?>

    Yukarıdaki örneğin çıktısı:

    There are 5 monkeys in the tree

    Biçem dizgesini ayrı bir dosyada oluşturduğunuzu varsayalım. Çünkü ona u12a uygulamak ve yeniden yazmak istiyoruz:

    <?php
    $format     = 'The %s contains %d monkeys';
    echo     sprintf($format, $num, $location);
    ?>

    Artık bir sorunumuz var. Biçem dizgesindeki belirteçlerin sırası koddaki bağımsız değişken sırasına uygun değil. Koda dokunmak istemiyoruz, biçem dizgesindeki belirteçler koda uyum sağlasın istiyoruz. Bu durumda biçem dizgesini şöyle yararız:

    <?php
    $format     = 'The %2$s contains %1$d monkeys';
    echo     sprintf($format, $num, $location);
    ?>

    Belirteçlerin bir yararı da koda bağımsız değişken eklemeksizin belirteçlerin yinelenebilmesidir.

    <?php
    $format     = 'The %2$s contains %1$d monkeys.
    That\'s a nice %2$s full of %1$d monkeys.'    ;
    echo     sprintf($format, $num, $location);
    ?>

    Bağımsız değişken takaslama yapılırken n$konum belirteci hemen yüzde iminden (%) sonra, diğer belirteçlerden önce gelmelidir; aşağıdaki gibi:

    Örnek 2 - Dolgu karakteri belirtmek

    <?php
    echo sprintf("%'.9d\n", 123);
    echo     sprintf("%'.09d\n", 123);
    ?>

    Yukarıdaki örneğin çıktısı:

    +......123 +000000123

    Örnek 3 - Konum belirteçlerini diğer belirteçlerle birlikte kullanmak

    <?php
    +$format = 'The %2$s contains %1$04d monkeys';
    +echo     sprintf($format, $num, $location);
    ?>

    Yukarıdaki örneğin çıktısı:

    The tree contains 0005 monkeys

    Örnek 4 - sprintf() ve sıfır dolgulu tamsayılar

    <?php
    $isodate     = sprintf("%04d-%02d-%02d", $year, $month, $day);
    ?>

    Örnek 5 - sprintf() ve para biçemleme

    <?php
    $money1     = 68.75;
    $money2 = 54.35;
    $money = $money1 + $money2;
    echo     $money;
    echo     "\n";
    $formatted = sprintf("%01.2f", $money);
    echo     $formatted;
    ?>

    Yukarıdaki örneğin çıktısı:

    123.1 123.10

    Örnek 6 - sprintf() ve bilimsel gösterim

    <?php
    $number     = 362525200;

    echo     sprintf("%.3e", $number);
    ?>

    Yukarıdaki örneğin çıktısı:

    3.625e+8

    Ayrıca Bakınız

    • printf() - Biçemli bir dizge çıktılar
    • fprintf() - Biçemli dizgeyi bir akıma yazar
    • vprintf() - Biçemli bir dizge çıktılar
    • vsprintf() - Biçemli bir dizge döndürür
    • vfprintf() - Biçemli dizgeyi bir akıma yazar
    • sscanf() - Girdi dizgesini belli bir biçeme göre yorumlar
    • fscanf() - Bir dosyadaki girdiyi belli bir biçeme göre çözümler
    • number_format() - Sayıyı binlik bölümlere ayırır
    • date() - Unix zaman damgasını biçimlendirir
    To Top