ltrim

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

    ltrim — Retira espacios en blanco (u otros caracteres) del inicio de un string

    Descripción

    ltrim(string$str, string$character_mask = ?): string

    Retira espacios en blanco (u otros caracteres) del inicio de un string.

    Parámetros

    str

    El string de entrada.

    character_mask

    Se puede también especificar los caracteres que se desean retirar por medio del parámetro character_mask. Simplemente se listan todos los caracteres que se quieren retirar. Con .. se puede especificar un rango de caracteres.

    Valores devueltos

    Esta función devuelve un string con los espacios en blanco retirados del inicio de str. Sin el segundo parámetro, ltrim() retirará estos caracteres:

    • " " (ASCII32 (0x20)), un espacio ordinario.
    • "\t" (ASCII9 (0x09)), un tabulador.
    • "\n" (ASCII10 (0x0A)), una nueva línea (line feed).
    • "\r" (ASCII13 (0x0D)), un retorno de carro.
    • "\0" (ASCII0 (0x00)), el byte NULL.
    • "\x0B" (ASCII11 (0x0B)), un tabulador vertical.

    Ejemplos

    Ejemplo #1 Ejemplo 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);

    // retira los caracteres ASCII de control al inicio de $binary
    // (de 0 a 31 inclusive)
    $clean = ltrim($binary, "\x00..\x1F");
    var_dump($clean);

    ?>

    El resultado del ejemplo sería:

    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 "

    Ver también

    • trim() - Elimina espacio en blanco (u otro tipo de caracteres) del inicio y el final de la cadena
    • rtrim() - Retira los espacios en blanco (u otros caracteres) del final de un string
    To Top