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.

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