(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
mb_strcut — Coupe une partie de chaîne
mb_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.
string
La 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é.
encoding
Le 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. |