ltrim

(PHP 4, PHP 5, PHP 7)

ltrimRetira espaços em branco (ou outros caracteres) do início da string

Descrição

ltrim ( string $str [, string $charlist ] ) : string

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

Parâmetros

str

A string de entrada.

charlist

Você pode também especificar os caracteres que você quer retirar, para isso, use o parâmetro charlist. Simplesmente liste todos os caracteres que você quer que seja removido. Com .. você pode especificar um intervalo de caracteres.

Valor Retornado

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

  • " " (ASCII 32 (0x20)), um espaço normal.
  • "\t" (ASCII 9 (0x09)), uma tabulação.
  • "\n" (ASCII 10 (0x0A)), uma linha nova (line feed).
  • "\r" (ASCII 13 (0x0D)), um retono de carro.
  • "\0" (ASCII 0 (0x00)), o byte NULL.
  • "\x0B" (ASCII 11 (0x0B)), uma tabulação vertical.

Changelog

Versão Descrição
4.1.0 O parâmetro charlist foi adicionado.

Exemplos

Exemplo #1 Exemplo de uso da 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);

// trim the ASCII control characters at the beginning of $binary 
// (from 0 to 31 inclusive)
$clean ltrim($binary"\x00..\x1F");
var_dump($clean);

?>

O exemplo acima irá imprimir:

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 no ínicio e final de uma string
  • rtrim() - Retira espaço em branco (ou outros caracteres) do final da string