PHP 8.3.4 Released!

trim

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

trimRimuove 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

up
11
pcoates at yukon1000 dot com
10 months 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']) : '';
up
0
gwyneth dot llewelyn at gwynethllewelyn dot net
8 months 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
To Top