array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.trim.php', 1 => 'trim', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.substr.php', 1 => 'substr', ), 'next' => array ( 0 => 'function.ucfirst.php', 1 => 'ucfirst', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/trim.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
trim — Retira espaço (ou outros caracteres) do início e do final de uma string
Esta função retorna uma string com os espaços retirados do
ínicio e do final de string
.
Sem o segundo parâmetro,
trim() irá retirar estes caracteres
32
(0x20
)), um espaço normal.
9
(0x09
)), uma tabulação.
10
(0x0A
)), uma linha nova (alimentação de linha).
13
(0x0D
)), um retono de carro.
0
(0x00
)), o byte NUL
.
11
(0x0B
)), uma tabulação vertical.
string
A string que será modificada.
characters
Opcionalmente, os caracteres removidos pode também ser especificados usando
o parâmetro characters
.
Simplesmente liste todos os caracteres que você quer retirar. Com
..
você pode especificar um intervalo de caracteres.
A string com caracteres removidos.
Exemplo #1 Exemplo de uso de trim()
<?php
$text = "\t\tThese are a few words :) ... ";
$binary = "\x09Example string\x0A";
$hello = "Hello World";
var_dump($text, $binary, $hello);
print "\n";
$trimmed = trim($text);
var_dump($trimmed);
$trimmed = trim($text, " \t.");
var_dump($trimmed);
$trimmed = trim($hello, "Hdle");
var_dump($trimmed);
$trimmed = trim($hello, 'HdWr');
var_dump($trimmed);
// retira os caracteres ASCII de controle no início e fim de $binary
// (de 0 a 31 inclusive)
$clean = trim($binary, "\x00..\x1F");
var_dump($clean);
?>
O exemplo acima produzirá:
string(32) " These are a few words :) ... " string(16) " Example string " string(11) "Hello World" string(28) "These are a few words :) ..." string(24) "These are a few words :)" string(5) "o Wor" string(9) "ello Worl" string(14) "Example string"
Exemplo #2 Usando trim() em valores de array
<?php
function trim_value(&$value)
{
$value = trim($value);
}
$fruit = array('apple','banana ', ' cranberry ');
var_dump($fruit);
array_walk($fruit, 'trim_value');
var_dump($fruit);
?>
O exemplo acima produzirá:
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" }
Nota: Possível armadilha: removendo caracteres no meio da string
Como trim() retira caracteres do início de do fim de uma string, pode ser confuso quando caracteres são (ou não) removidos do meio.
trim('abc', 'bad')
remove tanto 'a' quanto 'b' porque ele retira 'a', portanto move 'b' para o início e também será retirado. Portanto, este é o motivo pelo qual isso "funciona" enquanto quetrim('abc', 'b')
aparentemente não funciona.