(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.
Yorumlanacak dizge.
Girdi 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";
?>