(PHP 4 >= 4.0.1, PHP 5)
sscanf — Girdi dizgesini belli bir biçeme göre yorumlar
sscanf() işlevi, printf() işlevinin
tersine çıktıyı biçemlemek yerine girdiyi bir biçeme göre çözümler.
sscanf() belirtilen dizge
dizgesini okur ve ayrıntıları sprintf() belgesinde
açıklanan bir biçem dizgesine göre bu dizgeyi
yorumlar.
Biçem dizgesindeki herhangi bir boşluk karakteri girdi dizgesindeki herhangi bir boşluk karakteriyle eşleşir. Yani, biçem dizgesindeki bir sekme karakteri (\t) girdi dizgesindeki tek bir boşluk karakteri ile eşleşebilir.
dizgeYorumlanacak dizge.
biçemGirdi dizgesinin yorumlanmasında kullanılacak dizge. Bu dizge ile ilgili ayrıntılar için sprintf() işlevinin belgesine bakınız.
...Çözümlenen değerleri içermek üzere aktarımı isteğe bağlı gönderimli değişkenler.
İşleve sadece iki değiştirge aktarılmışsa, çözümlenen değerler bir dizi içinde döndürülür. İsteğe bağlı değiştirgeler belirtilmişse işlev bu değiştirgelere atanan değer sayısını döndürür. İsteğe bağlı değiştirgelerin gönderimli olarak aktarılmaları gerekir.
Örnek 1 - sscanf() örneği
<?php
// Seri numarasını döndürelim
list($serial) = sscanf("SN/2350001", "SN/%d");
// üretim tarihini de döndürelim
$mandate = "January 01 2000";
list($month, $day, $year) = sscanf($mandate, "%s %d %d");
echo "$serial numaralı mal şu tarihte üretildi: $year-" .
substr($month, 0, 3) . "-$day\n";
?>
İşleve isteğe bağlı değiştirgeler belirtilmişse işlev bu değiştirgelere atanan değer sayısını döndürür.
Örnek 2 - Seçimlik değiştirgelerle sscanf() kullanımı
<?php
// Yazar bilgisiyle bir DocBook girdisi üretelim
$auth = "24\tLewis Carroll";
$n = sscanf($auth, "%d\t%s %s", $id, $first, $last);
echo "<author id='$id'>
<firstname>$first</firstname>
<surname>$last</surname>
</author>\n";
?>