(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
grapheme_substr — Bir alt dizge döndürür
Yordamsal kullanım
Bir alt dizge döndürür.
dizgeAramanın yapılacağı dizge. Geçerli bir UTF-8 dizgesi olmalıdır.
başlangıç
Sesletim birimi cinsinden döndürülecek dizgenin başlangıç konumu.
başlangıç negatifse, dönen dizgenin başlangıç
konumu dizge'nin sonundan itibaren sayılır,
değilse dizge'nin başlangıcından itibaren
sıfırdan başlayarak sayılır.
uzunluk
Sesletim birimi cinsinden döndürülecek dizgenin uzunluğu. Eğer
uzunluk pozitifse, dizgenin başından itibaren
başlangıç'ıncı konumdan başlayan (dizgenin
uzunluğuna bağlı olarak) en fazla uzunluk sayıda
sesletim birimi döner. Eğer dizge, başlangıç
sayıda sesletim birimi içermiyorsa veya ancak bu kadar sesletim birimi
içeriyorsa işlev false döndürür. Eğer uzunluk
negatifse, döndürülecek dizgenin son sesletim birimi, dizgenin sonundan
itibaren uzunluk'uncu sesletim birimi olur. Eğer
başlangıç da negatifse, dizgenin sonundan
itibaren önce başlangıç birim sayılıp
döndürülecek dizgenin son sesletim birimine ulaşılır sonra da bu
konumdan itibaren sayılan uzunluk'uncu birim
döndürülecek dizgenin ilk sesletim birimi olur.
Bir dizge parçası, başarısızlık durumunda false döner.
| Sürüm: | Açıklama |
|---|---|
| 8.0.0 |
İşlev artık sınır dışı başlangıçları daima dizge sınırına kenetliyor.
Evvelce, bazı durumlarda false yerine boş dizge dönerdi.
|
Örnek 1 - grapheme_substr() örneği
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'å' (U+00E5) normalleştirme biçimi "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'ö' (U+00F6) normalleştirme biçimi "D"
print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" .
$char_o_diaeresis_nfd . "O", 2, -1 ));
?>Yukarıdaki örneğin çıktısı:
a%CC%8Abco%CC%88