(PHP 4, PHP 5)
substr — Restituisce parte di una stringa
$string
, int $start
[, int $length
] )
La funzione substr() restituisce la porzione di string
indicata dai parametri start e
length.
Se start non è negativo, la stringa restituita
inizierà dalla posizione start di
string, partendo da zero. Ad esempio,
nella stringa 'abcdef', il carattere alla posizione
0 è 'a', il carattere alla
posizione 2 è
'c', e così via.
Example #1 Esempi di base di 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
// Accedere al singolo carattere
// tramite le parentesi graffe è un'altra possibilità
$string = 'abcdef';
echo $string{0}; // a
echo $string{3}; // d
echo $string{strlen($string)-1}; // f
?>
Se start è negativo, la stringa restituita
inizierà dal carattere start
dalla fine di string.
Example #2 Utilizzo di valori negativi di start
<?php
$rest = substr("abcdef", -1); // restituisce "f"
$rest = substr("abcdef", -2); // restituisce "ef"
$rest = substr("abcdef", -3, 1); // restituisce "d"
?>
Se length è indicato ed è positivo, la stringa
restituita conterrà almeno length caratteri
partendo da start (in base alla lunghezza di
string). Se string è minore
o uguale a start, la funzione restituisce
FALSE
Se length è indicato ed è negativo, allora saranno omessi
length caratteri dalla fine di string
(dopo avere calcolato la posizione iniziale, nel caso in cui
start sia negativo). Se
start indica una posizione successiva a questo troncamento,
la funzione restituirà una stringa vuota.
Example #3 Utilizzo di valori negativi per length
<?php
$rest = substr("abcdef", 0, -1); // returns "abcde"
$rest = substr("abcdef", 2, -1); // returns "cde"
$rest = substr("abcdef", 4, -4); // returns ""
$rest = substr("abcdef", -3, -1); // returns "de"
?>
Vedere anche strrchr(), substr_replace(), ereg(), trim(), mb_substr() e wordwrap().