substr

substr -- Retourne un segment de chaîne

Description

string substr ( string string, int start [, int length])

substr( ) retourne le segment de string définit 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

 
vis

 
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é 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 seront 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( ) et ereg( ) .