(PHP 4, PHP 5)
substr — Dizgenin bir kısmını döndürür
dizge 'nin başlangıç 'tan itibaren uzunluk uzunluğunda parçasını döndürür.
Girilen dizge.
Eğer başlangıç değiştirgesi negatif değilse geri dönen dizge değeri, dizge 'nin 0'dan itibaren başlangıç 'ıncı konumundan başlar. Mesela, 'abcdef' dizgesinde, 0'ıncı konumdaki karakter 'a', 2'inci konumdaki karakter 'c'dir.
Eğer başlangıç değiştirgesi negatif ise, dönen dizge değeri dizge 'nin sonundan başlangıç karakter önce başlar.
Eğer dizge dizgesinin uzunluğu başlangıç dizgesinin uzunluğundan küçükse ya da eşitse işlev FALSE döndürür.
Örnek 1 - Negatif başlangıç kullanımı
<?php
$rest = substr("abcdef", -1); // "f" döndürür
$rest = substr("abcdef", -2); // "ef" döndürür
$rest = substr("abcdef", -3, 1); // "d" döndürür
?>
Eğer uzunluk değiştirgesi verildiyse ve pozitifse dönen dizge, dizge 'nin uzunluğuna göre başlangıç 'tan itibaren uzunluk 'ta belirtilen karakter sayısı kadar karakter içerir.
Eğer uzunluk değiştirgesi verildiyse ve negatifse dizge 'nin sonundan belirtilen kadar karakter çıkartılır (başlangıç negatif ise önce başlagıç konumu hesaplanır). Eğer başlangıç değiştirgesi negatif uzunlukla çıkarılan parçanın içindeki bir yeri işaret ediyorsa boş dizge döner.
Örnek 2 - Negatif uzunluk kullanımı
<?php
$rest = substr("abcdef", 0, -1); // "abcde" döndürür
$rest = substr("abcdef", 2, -1); // "cde" döndürür
$rest = substr("abcdef", 4, -4); // "" döndürür
$rest = substr("abcdef", -3, -1); // "de" döndürür
?>
Dizgenin çıkarılan kısmını döndürür.
Örnek 3 - Basit substr() kullanımı
<?php
echo substr('abcdef', 1); // bcdef
echo substr('abcdef', 1, 3); // bcd
echo substr('abcdef', 0, 4); // abcd
echo substr('abcdef', 0, 8); // abcdef
echo substr('abcdef', -1, 1); // f
// Dizge içerisindeki tek bir karaktere ulaşmak için
// "köşeli ayraçlar" da kullanılabilir.
$dizge = 'abcdef';
echo $dizge[0]; // a
echo $dizge[3]; // d
echo $dizge[strlen($dizge)-1]; // f
?>