(PHP 4, PHP 5)
substr — Retourne un segment de chaîne
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 2653. 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 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 .
Exemple 2654. 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 2655. 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() .