(PHP 4, PHP 5)
split — Belirtilen dizgeyi düzenli ifadeye göre dizi elemanlarına böler
Bu işlevin kullanımı PHP 5.3.0'dan beri ÖNERİLMEMEKTEDİR ve PHP 7.0.0'da tamamen KALDIRILMIŞTIR.
Bu işlevin yerine kulllanılabilecekler:
$şablon
, string $dizge
[, int $sınır = -1
] ) : arrayBelirtilen dizgeyi düzenli ifadeye göre dizi elemanlarına böler.
şablonHarf 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.
dizgeGirdi dizgesi.
sınır
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";
?>
split() işlevinin kullanımı PHP 5.3.0 itibariyle önerilmemektedir. Yerine preg_split() kullanın. 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.