Forum und email

substr

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

Example#1 Exemple avec substr()

<?php
echo substr('abcdef'1);     // bcdef
echo substr('abcdef'13);  // bcd
echo substr('abcdef'04);  // abcd
echo substr('abcdef'08);  // abcdef
echo substr('abcdef', -11); // f

// Accéder Ã  un simple caractère dans une chaîne
// peut Ã©galement Ãªtre réalisé en utilisant des accolades
$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 caractère numéro start à compter de la fin de la chaîne string .

Example#2 Exemple de start négatif

<?php
$rest 
substr("abcdef", -1);    // retourne "f"
$rest substr("abcdef", -2);    // retourne "ef"
$rest substr("abcdef", -31); // 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.

Example#3 Utiliser une valeur négative avec 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(), preg_match(), trim(), mb_substr() et wordwrap().