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
"

参考

md5_file

localeconv

Last updated: Fri, 25 Jul 2008

add a note User Contributed Notes
ltrim

Usamah M dot Ali (usamah1228 at gmail dot com)
05-Feb-2008 07: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
07-Aug-2006 04:13


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

jan
10-Jul-2006 06:30


if you have a numer like 0310, don't use this code:



$number = '0310';

$number = ltrim( $number, "\0x30" );

echo $number;



output: 10



for a correct output use:



$number = '0310';

$number = ltrim( $number, "0" );

echo $number;



output: 310



the "\0x30" works only with the first 32 ascii characters

add a note

md5_file

localeconv

Last updated: Fri, 25 Jul 2008