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().