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
$rest
= substr("abcdef", 1);    // restituisce "bcdef"
$rest = substr("abcdef", 1, 3); // restituisce "bcd"
$rest = substr("abcdef", 0, 4); // restituisce "abcd"
$rest = substr("abcdef", 0, 8); // restituisce "abcdef"

// Accedere tramite le parentesi graffe è un'altra possibilità
$string = 'abcdef';
echo
$string{0};                // restituisce a
echo $string{3};                // restituisce d
?>

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

Hosting by: hurra.com
Generated: 2007-01-26 17:56:34