ltrim

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

ltrim — Elimina los espacios (u otros caracteres) del inicio de un string

Descripción

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

Elimina los espacios (u otros caracteres) del inicio de un string.

Sin el segundo parámetro, ltrim() eliminará estos caracteres:

  • " ": carácter SP en ASCII 0x20, un espacio ordinario.
  • "\t": carácter HT en ASCII 0x09, una tabulación.
  • "\n": carácter LF en ASCII 0x0A, un salto de línea (line feed).
  • "\r": carácter CR en ASCII 0x0D, un retorno de carro.
  • "\0": carácter NUL en ASCII 0x00, el octeto NUL.
  • "\v": carácter VT en ASCII 0x0B, una tabulación vertical.

Parámetros

string
El string de entrada.
characters
Opcionalmente, los caracteres a eliminar también pueden ser especificados utilizando el parámetro characters. Basta con listar todos los caracteres que deben ser eliminados. Con .., es posible especificar un rango creciente de caracteres.

Valores devueltos

Esta función devuelve un string con los espacios eliminados al inicio del string.

Ejemplos

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

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

?>

El ejemplo anterior mostrará:

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
"

Véase también

  • trim() - Elimina los espacios (u otros caracteres) al inicio y al final de un string
  • rtrim() - Elimina los espacios (u otros caracteres) al final de un string