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() - 文字列の最後から空白 (もしくはその他の文字) を取り除く

md5_file

localeconv

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes ltrim

dzek dot remove_this at dzek dot eu 25-Jul-2011 01:27


Guys, if += 0 is producing wrong values sometimes, and preg_replace is cpu consuming, then just stick to the main function described on that page, and use:

<?php

$value = ltrim($value, '0');

?>

should be the fastest and most reliable.

I think all those comments can be misleading for begginers checking this page - it's sort of using magic tricks to reinvent the wheel.

Mike 08-Jan-2011 12:03


Keep in mind the amount of resources preg_replace() uses.  

I would suggest a simple if statement if you need to parse through large amounts of data.  

<?php

function remove_leading_zeros_from_number($number_string) {

  $limit = 9000.1

  $temp = $number

  (float) $temp;

  if ($number < $limit) {

    $number += 0;

  } else {

    preg_replace('~^[0]*([1-9][0-9]*)$~','$1',$number_string)

  }

}

?>



Code is untested, but probably sound.

tanmar.de 06-May-2010 10:36


The neat trick from Mr. Sherwood has only one ugly side-effect: If the "number" contained in the string is considerably large, you will end up with an int (or float) value that has nothing to do with the original number ...



You may use preg_replace instead:



$number_string = preg_replace('~^[0]*([1-9][0-9]*)$~','$1',$number_string);



This kills any leading zeros safely without changing any other data.



Hope this helps.

Usamah M dot Ali (usamah1228 at gmail dot com) 04-Feb-2008 02: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 12:13


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

add a note