Manuel PHP

substr

(PHP 4, PHP 5)

substrRetourne un segment de chaîne

Description

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

Retourne le segment de string défini par start et length .

Liste de paramètres

string

La chaîne d'entrée.

start

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. Actuellement, dans la chaîne 'abcdef', le caractère à la position 0 est 'a', le caractère à la position 2 est 'c', et ainsi de suite.

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 #1 Exemple de start négatif

  1. <?php
  2. $rest = substr("abcdef", -1);   // retourne "f"
  3. $rest = substr("abcdef", -2);   // retourne "ef"
  4. $rest = substr("abcdef", -3, 1); // retourne "d"
  5. ?> 

length

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 #2 Utilisation d'une valeur négative pour length

  1. <?php
  2. $rest = substr("abcdef", 0, -1); // retourne "abcde"
  3. $rest = substr("abcdef", 2, -1); // retourne "cde"
  4. $rest = substr("abcdef", 4, -4); // retourne ""
  5. $rest = substr("abcdef", -3, -1); // retourne "de"
  6. ?> 

Valeurs de retour

Retourne la partie extraite de la chaîne.

Exemples

Exemple #3 Exemple avec substr()

  1. <?php
  2. echo substr('abcdef', 1);   // bcdef
  3. echo substr('abcdef', 1, 3); // bcd
  4. echo substr('abcdef', 0, 4); // abcd
  5. echo substr('abcdef', 0, 8); // abcdef
  6. echo substr('abcdef', -1, 1); // f
  7.  
  8. // Accéder à un simple caractère dans une chaîne
  9. // peut également être réalisé en utilisant des crochets
  10. $string = 'abcdef';  
  11. echo $string[0];            // a
  12. echo $string[3];            // d
  13. echo $string[strlen($string)-1]; // f
  14.  
  15. ?> 


Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto