array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.ltrim.php', 1 => 'ltrim', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'Funções de String', ), 'prev' => array ( 0 => 'function.localeconv.php', 1 => 'localeconv', ), 'next' => array ( 0 => 'function.md5-file.php', 1 => 'md5_file', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/strings/functions/ltrim.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
ltrim — Retira espaços em branco (ou outros caracteres) do início de uma string
Retira espaços em branco (ou outros caracteres) do início de uma string.
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.
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:
32
(0x20
)), um espaço normal.
9
(0x09
)), uma tabulação.
10
(0x0A
)), uma linha nova (alimentação de linha).
13
(0x0D
)), um retono de carro.
0
(0x00
)), o byte NUL
.
11
(0x0B
)), uma tabulação vertical.
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 "