Manuel PHP

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

  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 accolades
  10. $string = 'abcdef';  
  11. echo $string{0};            // a
  12. echo $string{3};            // d
  13. echo $string{strlen($string)-1}; // f
  14.  
  15. ?> 

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

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

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

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

Voir aussi strrchr(), substr_replace(), preg_match(), trim(), mb_substr() et wordwrap().

L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Php - Breizh Blog