rtrim

(PHP 4, PHP 5, PHP 7)

rtrimRetira espaço em branco (ou outros caracteres) do final da string

Descrição

rtrim ( string $str [, string $charlist ] ) : string

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

Exemplo #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"

Veja Também

  • trim() - Retira espaço no ínicio e final de uma string
  • ltrim() - Retira espaços em branco (ou outros caracteres) do início da string