substr_compare

(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

Açıklama

substr_compare(
    string$samanlık,
    string$iğne,
    int$başlangıç,
    ?int$uzunluk = null,
    bool$büyüklük_duyarsız = false
): int

substr_compare() işlevi samanlık dizgesinin başlangıç'tan itibaren uzunluk karakterlik parçasını iğne dizgesiyle karşılaştırır.

Bağımsız Değişkenler

samanlık: Karşılaştırılacak ana dizge.
iğne: Karşı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ıztrue ise, karşılaştırmada harf büyüklükleri dikkade alınmaz.

Dönen Değerler

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 Bilgisi

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.

Örnekler

Ö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ı
?>

Ayrıca Bakınız

strncmp() - İlk n karakteri ikil olarak karşılaştırır