substr

(PHP 3, PHP 4 )

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&eacute;der aux caract&egrave;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 caractère numéro start dans 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 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() et trim().