ltrim

(PHP 4, PHP 5)

ltrim — 文字列の最初から空白 (もしくはその他の文字) を取り除く

説明

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

文字列の最初から空白 (もしくはその他の文字) を取り除きます。

パラメータ

str: 入力文字列。
charlist: charlist パラメータにより、削除する文字を指定することも可能です。削除したい全ての文字をリストにしてください。..を文字の範囲を指定する際に使用可能です。

返り値

この関数は文字列の最初から空白文字を取り除き、取り除かれた文字列を返します。2番目のパラメータを指定しない場合、 ltrim()は以下の文字を削除します。

" " (ASCII 32 (0x20)), 通常の空白。
"\t" (ASCII 9 (0x09)), タブ。
"\n" (ASCII 10 (0x0A)), 改行。
"\r" (ASCII 13 (0x0D)), 復帰。
"\0" (ASCII 0 (0x00)), NUL バイト。
"\x0B" (ASCII 11 (0x0B)), 垂直タブ。

変更履歴

バージョン	説明
4.1.0	`charlist` パラメータが追加されました。

例

例1 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);

// ASCII 制御文字 (0 から 31 まで) を
// $binary の先頭から取り除きます
$clean = ltrim($binary, "\x00..\x1F");
var_dump($clean);

?>

上の例の出力は以下となります。

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
"

参考

trim() - 文字列の先頭および末尾にあるホワイトスペースを取り除く
rtrim() - 文字列の最後から空白 (もしくは他の文字) を削除する

add a note User Contributed Notes
ltrim

Usamah M dot Ali (usamah1228 at gmail dot com)
04-Feb-2008 10:42


For those who use right-to-left languages such as Arabic, Hebrew, etc., it's worth mentioning that ltrim() (which stands for left trim) & rtrim() (which stands for right trim) DO NOT work contextually. The nomenclature is rather semantically incorrect. So in an RTL script, ltrim() will trim text from the right direction (i.e. beginning of RTL strings), and rtrim() will trim text from the left direction (i.e. end of RTL strings).

John Sherwood
06-Aug-2006 07:13


To remove leading/trailing zeroes (example: "0123.4560"), doing a += 0 is easier than trim tricks.

add a note

md5_file

localeconv

Last updated: Fri, 13 Nov 2009