(PHP 4, PHP 5, PHP 7, PHP 8)
trim — Rimuove gli spazi (ed altri caratteri) all'inizio e alla fine di un testo
Questa funzione restituisce il parametro str
privo degli spazi iniziali e finali.
Senza la specifica del secondo parametro,
trim() rimuoverà questi caratteri:
32
(0x20)), spazio.
9
(0x09)), il carattere tab.
10
(0x0A)), il new line (line feed).
13
(0x0D)), il carriage return.
0
(0x00)), il byte NUL.
11
(0x0B)), il tab verticale.
strLa 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.
La stringa troncata.
| Versione | Descrizione |
|---|---|
| 4.1.0 |
E' stato aggiunto il parametro opzionale charlist.
|
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"
}
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']) : '';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