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

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

add a note

User Contributed Notes 2 notes

down

pcoates at yukon1000 dot com ¶

1 year ago


note there is a behaviour change in php 8

You used to be able to say:
$p1 = trim($_POST['p1']);
This will now throw deprecated warnings if parameter p1 is not set. It is better to say:
$p1 = trim($_POST['p1']??'');
or 
$p1 = isset($_POST['p1']) ? trim($_POST['p1']) : null;
or
$p1 = isset($_POST['p1']) ? trim($_POST['p1']) : '';

down

gwyneth dot llewelyn at gwynethllewelyn dot net ¶

1 year ago


Note that trim() is not aware of Unicode points that represent whitespace (e.g., in the General Punctuation block), except, of course, for the ones mentioned in this page.

There is no Unicode-specific trim function in PHP at the time of writing (July 2023), but you can try some examples of trims using multibyte strings posted on the comments for the mbstring extension: https://www.php.net/manual/en/ref.mbstring.php

add a note