trim

(PHP 4, PHP 5, PHP 7, PHP 8)

trim — Rimuove gli spazi (ed altri caratteri) all'inizio e alla fine di un testo

Descrizione

trim(string $str, string $charlist = ?): string

Questa funzione restituisce il parametro str privo degli spazi iniziali e finali. Senza la specifica del secondo parametro, trim() rimuoverà questi caratteri:

" " (ASCII 32 (0x20)), spazio.
"\t" (ASCII 9 (0x09)), il carattere tab.
"\n" (ASCII 10 (0x0A)), il new line (line feed).
"\r" (ASCII 13 (0x0D)), il carriage return.
"\0" (ASCII 0 (0x00)), il byte NUL.
"\x0B" (ASCII 11 (0x0B)), il tab verticale.

Elenco dei parametri

str: La stringa che deve essere troncata.
charlist: Opzionale, Si può, inoltre, specificare quali caratteri si desidera rimuovere elencandoli in charlist. Questo parametro è un semplice elenco dei caratteri da rimuovere. Con .. si può indicare un range di caratteri.

Valori restituiti

La stringa troncata.

Log delle modifiche

Versione Descrizione

4.1.0 E' stato aggiunto il parametro opzionale charlist.

Versione	Descrizione
4.1.0	E' stato aggiunto il parametro opzionale `charlist`.

Esempi

Example #1 Esempio di uso di trim()

<?php

$text = "\t\tThese are a few words :) ...  ";

echo trim($text);           // "These are a few words :) ..."
echo trim($text, " \t.");   // "These are a few words :)"

// rimuove i caratteri di controllo ASCII all'inizio ed alla fine di $binary
// (da 0 a 31 compresi)
$clean = trim($binary, "\x00..\x1F");

?>

Example #2 Trimming array values with trim()

<?php
function trim_value(&$value)
{
  $value = trim($value);
}

$fruit = array('apple','banana ', ' cranberry ');
var_dump($fruit);

array_walk($fruit, 'trim_value');
var_dump($fruit);

?>

Il precedente esempio visualizzerà:

array(3) {
  [0]=>
  string(5) "apple"
  [1]=>
  string(7) "banana "
  [2]=>
  string(11) " cranberry "
}
array(3) {
  [0]=>
  string(5) "apple"
  [1]=>
  string(6) "banana"
  [2]=>
  string(9) "cranberry"
}

Vedere anche:

ltrim() - Rimuove gli spazi (o altri caratteri) dall'inizio di una stringa
rtrim() - Rimuove gli spazi (ed altri caratteri) dalla fine della stringa