Manuel PHP
Précédent |  | Suivant

# substr

(PHP 3, PHP 4 , PHP 5)

substr -- Retourne un segment de chaîne

## Description

string substr ( string string, int start [, int length])

substr() retourne le segment de `string` défini par `start` et `length`.

Si `start` est positif, la chaîne retournée commencera au caractère numéro `start`, dans la chaîne `string`. Le premier caractère est numéroté zéro.

Exemple 1. Exemple avec substr()

`<?php $rest = substr("abcdef", 1); // retourne "bcdef" $rest = substr("abcdef", 1, 3); // retourne "bcd" $rest = substr("abcdef", 0, 4); // retourne "abcd" $rest = substr("abcdef", 0, 8); // retourne "abcdef" // Accéder aux caractères via les accolades $string = 'abcdef'; echo $string{0}; // retourne a echo $string{3}; // retourne d ?>`

Si `start` est négatif, la chaîne retournée commencera au `start`'ième caractère depuis la fin de la chaîne `string`.

Exemple 2. Exemple de `start` négatif

`<?php $rest = substr("abcdef", -1); // retourne "f" $rest = substr("abcdef", -2); // retourne "ef" $rest = substr("abcdef", -3, 1); // retourne "d" ?>`

Si `length` est fourni et est positif, la chaîne retournée contiendra au plus `length` caractères, en commençant à partir du caractère `start` (en fonction de la taille de la chaîne `string`). Si `string` est plus petite que `start`, substr() retournera `FALSE`.

Si `length` est fourni et négatif, alors le même nombre de caractères sera omis, en partant de la fin de la chaîne `string`. Si `start` représente une position hors de la chaîne, une chaîne vide sera retournée.

Exemple 3. Utiliser une valeur négative de `length`

`<?php $rest = substr("abcdef", 0, -1); // retourne "abcde" $rest = substr("abcdef", 2, -1); // retourne "cde" $rest = substr("abcdef", 4, -4); // retourne "" $rest = substr("abcdef", -3, -1); // retourne "de" ?>`

Voir aussi strrchr(), substr_replace(), ereg(), trim() et mb_substr().

Précédent | Sommaire | Suivant
substr_replace | Niveau supérieur | trim