stristr

(PHP 4, PHP 5, PHP 7, PHP 8)

stristrHarf büyüklüğüne duyarsız olarak ilk alt dizgeyi bulur

Açıklama

stristr(string $samanlık, string $iğne, bool $iğne_öncesi = false): string|false

samanlık dizgesinde bulunan ilk iğne dizgesiyle (iğne dahil) başlayan parçayı döndürür.

Bağımsız Değişkenler

samanlık

Girdi dizgesi.

iğne

Aranacak dizge.

PHP 8.0.0 öncesinde, iğne bir dizge değilse, bir tamsayıya dönüştürülür ve bir karakterin sıra değeri olarak uygulanırdı. PHP 7.3.0 itibariyle bu davranışın kullanımı önerilmemekte ve güvenilmemesi önerilmektedir. Amaçlanan davranışa bağlı olarak, iğne ya doğrudan dizgeye çarpıtılmalı ya da doğrudan bir chr() çağrısı yapılmalıdır.

iğne_öncesi

true ise, stristr() işlevi samanlık dizgesinde bulunan ilk iğne dizgesinde biten parçayı (iğne hariç) döndürür.

samanlık ve iğne harf büyüklüğüne duyarsız olarak ele alınır.

Dönen Değerler

iğne bulunamazsa false, aksi takdirde dizge parçası ile döner.

Sürüm Bilgisi

Sürüm: Açıklama
8.2.0 Büyük/küçük harf dönüşümü yalnızca ASCII karakterlere (baytlara) uygulandığından yerelin setlocale() ile atanması artık gerekmiyor. ASCII olmayan karakterlerin bayt değerleri karşılaştırılıyor.
8.0.0 iğne artık boş dizge kabul ediyor.
8.0.0 iğne olarak bir tamsayı aktarımı artık kabul edilmiyor.
7.3.0 iğne olarak bir tamsayı aktarımı artık önerilmiyor.

Örnekler

Örnek 1 - stristr() örneği

<?php
$email
= 'USER@EXAMPLE.com';
echo
stristr($email, 'e'); // ER@EXAMPLE.com basar
echo stristr($email, 'e', true); // US basar
?>

Örnek 2 Bir dizgenin varlığına bakmak

<?php
$string
= 'Hello World!';
if(
stristr($string, 'earth') === FALSE) {
echo
'"earth" bu dizgede yok';
}
// çıktısı: "earth" bu dizgede yok
?>

Örnek 3 - Dizge olmayan iğne kullanımı

<?php
$string
= 'APPLE';
echo
stristr($string, 97); // 97 = küçük a
// çıktısı: APPLE
?>

Notlar

Bilginize: Bu işlev ikil dosyalarla çalışırken dosya içeriğini değiştirmez.

Ayrıca Bakınız

  • strstr() - İlk alt dizgeyi bulur
  • strrchr() - Bir dizgede belli bir karakterin sonuncusuna göre dizgenin bir parçasıyla döner
  • stripos() - Harf büyüklüğüne duyarsız olarak bir alt dizgenin ilkinin konumunu bulur
  • strpbrk() - Belirtilen karakterleri bir dizge içinde arar
  • preg_match() - Bir düzenli ifadeyi eşleştirmeye çalışır