Manuale PHP
Indietro |  | Avanti

# substr

(PHP 3, PHP 4, PHP 5)

substr -- Restituisce parte di una stringa

## Descrizione

string substr ( string 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.

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

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

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

Indietro | Partenza | Avanti
substr_replace | Risali | trim