grapheme_substr
(PHP 5 >= 5.3.0, PECL intl >= 1.0.0)
grapheme_substr — Retourne une partie d'une chaîne
Description
Style procédural
$string
, int $start
[, int $length
] )Retourne une partie d'une chaîne.
Liste de paramètres
-
string -
La chaîne à couper. Doit être UTF-8 et valide.
-
start -
La position de début, en unité par de graphèmes. Si
$startest non-négatif, la chaîne retournée va commencer à la position$startdans la chaîne, en comptant à partir de 0. Si$startest négatif, la chaîne retournée va commencer à la position$starten comptant depuis la fin de la chaîne. -
length -
La taille de la sous-chaîne à extraire, en unités de graphème. Si
$lengthest donné et positif, la chaîne retournée va contenir au plus$lengthgraphèmes, commençant à$start(en fonction de la taille de la chaîne). Si$stringest fourni et est négatif, alors autant de graphème seront omis à partir de la fin de la chaîne (après que la position de début ait été calculé, lorsque$startest aussi négatif). Si$startdénote une position au-delà de la fin de la chaîne,FALSEsera retournée.
Valeurs de retour
Retourne la partie de chaîne extraite de $string.
Historique
| Version | Description |
|---|---|
| 5.4 |
Si length est fourni et est positif,
et la chaîne fournie est plus petite que la longueur spécifiée,
tout le reste de la chaîne, suivant le paramètre
start sera retourné. Précédemment,
FALSE était retourné.
|
Exemples
Exemple #1 Exemple avec grapheme_substr()
<?php
$char_a_ring_nfd = "a\xCC\x8A"; // 'LATIN SMALL LETTER A WITH RING ABOVE' (U+00E5) normalization form "D"
$char_o_diaeresis_nfd = "o\xCC\x88"; // 'LATIN SMALL LETTER O WITH DIAERESIS' (U+00F6) normalization form "D"
print urlencode(grapheme_substr( "ao" . $char_a_ring_nfd . "bc" . $char_o_diaeresis_nfd . "O", 2, -1 ));
?>L'exemple ci-dessus va afficher :
a%CC%8Abco%CC%88
Voir aussi
- grapheme_extract() - Extrait un groupe de graphème d'une chaîne UTF-8
- » Unicode Text Segmentation: Grapheme Cluster Boundaries
