(PHP 4 >= 4.0.6, PHP 5, PHP 7)
mb_strcut — Coupe une partie de chaîne
$str
, int $start
[, int $length
= NULL
[, string $encoding
= mb_internal_encoding()
]] ) : stringmb_strcut() extrait une sous-chaîne depuis une chaîne, d'une façon similaire à la fonction mb_substr(), mais opère sur les octets au lieu des caractères. Si le découpage intervient entre 2 octets d'un caractère multi-octets, le découpage sera effectué au début du premier octet de ce caractère. C'est également la différence avec la fonction substr() qui coupera la chaîne au milieu des octets, résultant ainsi en une séquence d'octets mal-formée.
str
La chaîne à couper.
start
Si start
est positif, la chaîne
retournée commencera à l'octet numéro start
,
dans la chaîne str
. Le premier caractère
est numéroté zéro. En effet, dans la chaîne 'abcdef',
l'octet à la position 0 est 'a',
l'octet à la position 2 est 'c',
et ainsi de suite.
Si start
est négatif, la chaîne retournée
commencera à l'octet numéro start
à compter
de la fin de la chaîne str
.
length
Longueur en octets. Si ce paramètre est omis, ou vaut NULL, tous les octets jusqu'à la fin de la chaîne seront extraits.
encoding
Le paramètre encoding
est l'encodage des caractères. S'il est omis, l'encodage de caractères interne
sera utilisé.
mb_strcut() retourne la portion de la chaîne
str
qui commence au caractère
start
et a la longueur de
length
caractères.
Version | Description |
---|---|
5.4.8 |
Passer NULL en tant que length
extrait tous les charactères jusqu'à la fin de la chaîne. Antérieur à cette
version NULL était traité de la même manière que 0.
|