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