(PHP 4, PHP 5)
split — Belirtilen dizgeyi düzenli ifadeye göre dizi elemanlarına böler
Belirtilen dizgeyi düzenli ifadeye göre dizi elemanlarına böler.
Evrenkod uyumsuzluğu nedeniyle bu işlevin kullanımı PHP 5.3.0'dan beri ÖNERİLMEMEKTEDİR.
Harf büyüklüğüne duyarlı düzenli ifade.
Düzenli ifadelere özgü karakterlerden birine göre bölme yapmak isterseniz o karakteri öncelemeniz gerekir. Eğer split() işlevinin (veya bu konu ile ilgili diğer düzenli ifade işlevlerinin) tuhaf şeyler yaptığını düşünüyorsanız, PHP dağıtımının regex/ alt dizininde bulunan regex.7 kılavuz sayfasını okuyunuz. Bir kılavuz sayfası olması nedeniyle kabukta man /usr/local/src/regex/regex.7 komutunu vererek dosyayı okuyabilirsiniz.
Girdi dizgesi.
Bu değiştirge belirtilmişse, son elemanında dizge'nin kalanını içermek üzere en fazla sınır sayıda eleman içeren bir dizi dönecektir.
Her elemanında, dizge dizgesinin, sınırları harf büyüklüğüne duyarlı şablon düzenli ifadesine göre belirlenen, alt dizgelerini içeren bir dizi döner.
şablon ile eşleşen n alt dizge varsa dönen dizi n+1 eleman içerecektir. Örneğin, şablon ile eşleşen hiçbir alt dizge yoksa, işlev tek elemanlı bir dizi döndürecektir. Bu durum dizge dizgesinin boş olduğu durumda da geçerlidir. Bir hata oluşursa işlev FALSE döndürür.
Örnek 1 - split() örneği - 1
/etc/passwd dosyasının her satırındaki ilk dört alanı seçmek için:
<?php
list($kullanıcı, $parola, $uid, $gid, $ek) =
split(":", $passwd_line, 5);
?>
Örnek 2 - split() örneği - 2
Bölü çizgisi, nokta ve tire ile ayrılan tarih alanlarını ayrıştırmak için:
<?php
// Ayraçları bölü çizgisi, nokta veya tire olabilir
$tarih = "04/30/1973";
list($ay, $gün, $yıl) = split('[/.-]', $tarih);
echo "Ay: $ay; Gün: $gün; Yıl: $yıl<br />\n";
?>
Bilginize:
PHP 5.3.0 ve sonrasında regex eklentisinin kullanımı artık önerilmemekte olup yerine PCRE eklentisinin kullanılması önerilmekte ve bu işleve yapılan çağrılar bu nedenle bir E_DEPRECATED uyarısı çıktılamaktadır.PCRE'ye dönüşümü kolaylaştırmak için fark listesine bakınız.
Perl uyumlu düzenli ifade sözdizimini kullanan preg_split() işlevi çoğunlukla bu işlevden daha hızlıdır. Bir düzenli ifadenin çok da gerekmediği yerlerde düzenli ifade motorunu yormayan explode() işlevi çok daha hızlıdır.
Perl'in @chars = split('', $str) davranışını taklit etmek için bir yol arayışında olanların preg_split() veya str_split() işlevlerinin örneklerine bakmaları önerilir.