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
echo substr('abcdef', 1);     // bcdef
echo substr('abcdef', 1, 3);  // bcd
echo substr('abcdef', 0, 4);  // abcd
echo substr('abcdef', 0, 8);  // abcdef
echo substr('abcdef', -1, 1); // f

// Accéder à un simple caractère dans une chaîne
// peut également être réalisé en utilisant des parenthèses
$string = 'abcdef';
echo
$string{0};                 // a
echo $string{3};                 // d
echo $string{strlen($string)-1}; // f

?>

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(), mb_substr() et wordwrap().