rtrim
(PHP 4, PHP 5)
rtrim — Retira espaço em branco (ou outros caracteres) do final da string
Descrição
string rtrim
( string
$str
[, string $charlist
] )
Esta função retorna a string com os espaços em branco retirados do final de
str.
Sem o segundo parâmetro, rtrim() irá retirar os seguintes caracteres:
- " " (ASCII 32 (0x20)), um espaço comum.
- "\t" (ASCII 9 (0x09)), uma tabulação.
- "\n" (ASCII 10 (0x0A)), uma nova linha.
- "\r" (ASCII 13 (0x0D)), um retorno de carro(ENTER).
- "\0" (ASCII 0 (0x00)), o byte NULL.
- "\x0B" (ASCII 11 (0x0B)), uma tabulação vertical.
Parâmetros
-
str -
A string de entrada.
-
charlist -
Você também pode especificar os caracteres que você deseja retirar, pelo parâmetro
charlist. Simplesmente liste todos os caracteres que você quer ver retirados. Com .. você pode especificar um intervalo de caracteres.
Valor Retornado
Retorna a string modificada.
Changelog
| Versão | Descrição |
|---|---|
| 4.1.0 |
O parâmetro charlist foi adicionado.
|
Exemplos
Example #1 Exemplo de uso da função rtrim()
<?php
$text = "\t\tThese are a few words :) ... ";
$binary = "\x09Example string\x0A";
$hello = "Hello World";
var_dump($text, $binary, $hello);
print "\n";
$trimmed = rtrim($text);
var_dump($trimmed);
$trimmed = rtrim($text, " \t.");
var_dump($trimmed);
$trimmed = rtrim($hello, "Hdle");
var_dump($trimmed);
// trim the ASCII control characters at the end of $binary
// (from 0 to 31 inclusive)
$clean = rtrim($binary, "\x00..\x1F");
var_dump($clean);
?>
O exemplo acima irá imprimir:
string(32) " These are a few words :) ... " string(16) " Example string " string(11) "Hello World" string(30) " These are a few words :) ..." string(26) " These are a few words :)" string(9) "Hello Wor" string(15) " Example string"