(PHP 4, PHP 5)
split — Belirtilen dizgeyi düzenli ifadeye göre dizi elemanlarına böler
$şablon
, string $dizge
[, int $sınır
] )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.
ş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";
?>
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_DEPRECATEDuyarı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.