# 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:

- " " (ASCII `32` (`0x20`)), un espacio ordinario.
- "\t" (ASCII `9` (`0x09`)), un tabulador.
- "\n" (ASCII `10` (`0x0A`)), una nueva línea (line feed).
- "\r" (ASCII `13` (`0x0D`)), un retorno de carro.
- "\0" (ASCII `0` (`0x00`)), el byte `NULL`.
- "\x0B" (ASCII `11` (`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