(PHP 5, PHP 7, PHP 8)
substr_compare — İki dizgenin belli bir konumdan itibaren belli uzunluktaki parçalarını bayt bayt karşılaştırır
$samanlık,$iğne,$başlangıç,$uzunluk = null,$büyüklük_duyarsız = false
substr_compare() işlevi samanlık
dizgesinin başlangıç'tan itibaren
uzunluk karakterlik parçasını
iğne dizgesiyle karşılaştırır.
samanlıkKarşılaştırılacak ana dizge.
iğneKarşılaştırılacak diğer dizge.
başlangıçKarşılaştırmanın başlayacağı konum. Negatifse, saymaya dizgenin sonundan itibaren başlanır.
uzunluk
Karşılaştırılacak uzunluk. iğne uzunluğu
ile (samanlık - başlangıç)
uzunluğu karşılaştırıldığında büyük olan uzunluk öntanımlıdır.
büyüklük_duyarsız
büyüklük_duyarsız true ise, karşılaştırmada
harf büyüklükleri dikkade alınmaz.
Eğer samanlık dizgesinin
başlangıç konumundan başlayan parçası
iğne dizgesinden küçükse -1,
büyükse 1, ikisi eşitse 0 döner.
Eğer uzunluk belirtilmişse ve
samanlık dizgesinin uzunluğundan
büyükse (PHP 7.2.18 ve 7.3.5 öncesinde eşitse)
substr_compare() bir uyarı basar ve false döndürür.
| Sürüm: | Açıklama |
|---|---|
| 8.2.0 |
Bu işlev artık -1 veya 1 döndürüyor,
evvelce pozitif vaya negatif bir sayı döndürürdü.
|
| 8.0.0 |
uzunluk artık null olabiliyor.
|
| 7.2.18, 7.3.5 |
başlangıç ile samanlık
uzunlukları artık eşit olabiliyor.
|
Örnek 1 - substr_compare() örneği
<?php
echo substr_compare("abcde", "bc", 1, 2); // 0
echo substr_compare("abcde", "de", -2, 2); // 0
echo substr_compare("abcde", "bcg", 1, 2); // 0
echo substr_compare("abcde", "BC", 1, 2, true); // 0
echo substr_compare("abcde", "bc", 1, 3); // 1
echo substr_compare("abcde", "cd", 1, 2); // -1
echo substr_compare("abcde", "abc", 5, 1); // uyarı
?>