ltrim

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

    ltrim — Retira espaços em branco (ou outros caracteres) do início de uma string

    Descrição

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

    Retira espaços em branco (ou outros caracteres) do início de uma string.

    Parâmetros

    string

    A string de entrada.

    characters

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

    Valor Retornado

    Esta função retorna uma string com espaços em branco retirados do início de string. Sem o segundo parâmetro, ltrim() retirará estes caracteres:

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

    Exemplos

    Exemplo #1 Exemplo de uso de ltrim()

    <?php

    $text     = "\t\tThese are a few words :) ... ";
    $binary = "\x09Example string\x0A";
    $hello = "Hello World";
    var_dump($text, $binary, $hello);

    print     "\n";


    $trimmed = ltrim($text);
    var_dump($trimmed);

    $trimmed = ltrim($text, " \t.");
    var_dump($trimmed);

    $trimmed = ltrim($hello, "Hdle");
    var_dump($trimmed);

    // tira os caracteres de controle ASCII do início de $binary
    // (de 0 a 31 inclusive)
    $clean = ltrim($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(30) "These are a few words :) ... " string(7) "o World" string(15) "Example string "

    Veja Também

    • trim() - Retira espaço (ou outros caracteres) do início e do final de uma string
    • rtrim() - Retira espaço em branco (ou outros caracteres) do final de uma string
    To Top