(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strcut — Coupe une partie de chaîne
$string,$start,$length = null,$encoding = nullmb_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 multioctets, 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.
stringLa chaîne à couper.
start
Si start est positif, la chaîne
retournée commencera à l'octet numéro start,
dans la chaîne string. 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 string. Cependant, si le
nombre négatif passé en paramètre start est supérieur
à la longueur de la chaîne, la portion retournée commencera depuis
le début de la chaîne string.
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.
Si length est négatif, la chaîne retournée
se finira à la position length en comptant
en arrière depuis la fin de la chaîne string.
Cependant, si le nombre négatif passé au paramètre
length est plus grand que le nombre de caractères
après la position start, une chaîne vide sera
retourné.
encodingLe paramètre encoding
est l'encodage des caractères. S'il est omis ou null, l'encodage de caractères interne
sera utilisé.
mb_strcut() retourne la portion de la chaîne
string qui commence au caractère
start et a la longueur de
length caractères.
| Version | Description |
|---|---|
| 8.0.0 |
encoding est désormais nullable.
|