rtrim

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

    rtrim — Retira espaço em branco (ou outros caracteres) do final de uma string

    Descrição

    rtrim(string$string, string$characters = " \n\r\t\v\x00"): string

    Esta função retorna uma string com os espaços (ou outros caracteres) retirados do final de string.

    Sem o segundo parâmetro, rtrim() irá retirar os seguintes caracteres:

    • " " (ASCII32 (0x20)), um espaço comum.
    • "\t" (ASCII9 (0x09)), uma tabulação.
    • "\n" (ASCII10 (0x0A)), uma nova linha.
    • "\r" (ASCII13 (0x0D)), um retorno de carro(ENTER).
    • "\0" (ASCII0 (0x00)), o byte NULL.
    • "\v" (ASCII11 (0x0B)), uma tabulação vertical.

    Parâmetros

    string

    A string de entrada.

    characters

    Pode-se também especificar outros caracteres que deseja-se que sejam retirados, por meio do parâmetro characters. Simplesmente liste todos os caracteres que devem ser retirados. Com .., pode-se especificar um intervalo de caracteres.

    Valor Retornado

    Retorna a string modificada.

    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);

    // Retira os caracteres de controle ASCII no final de $binary
    // (de 0 a 31 inclusive)
    $clean = rtrim($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(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 (ou outros caracteres) do início e do final de uma string
    • ltrim() - Retira espaços em branco (ou outros caracteres) do início de uma string
    To Top