(PHP 4, PHP 5, PHP 7, PHP 8)
trim — Retira espaço no início e final de uma string
$str, string $charlist = ?): string
Esta função retorna uma string com os espaçoes retirados do ínicio e do final
de str.
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 (line feed).
13
(0x0D)), um retono de carro.
0
(0x00)), o byte NULL.
11
(0x0B)), uma tabulação vertical.
strA string que será modificada.
charlist
Opcionalmente, os caracteres removidos pode também ser especificados usando
o parâmetro charlist.
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);
// trim the ASCII control characters at the beginning and end of $binary
// (from 0 to 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(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"
}