الدالة ltrim()‎ في PHP

(PHP 4, PHP 5, PHP 7)

تزيل الدالة ltrim()‎ المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية السلسلة النصيَّة الممررَّة إليها.

الوصف

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

تزيل الدالة ltrim()‎ المسافات البيضاء أو أي محرف آخر من بداية السلسلة النصيَّة str.

المعاملات

str

السلسلة النصيَّة التي ستجرى عليها العمليَّة.

character_mask

معامل اختياري، وهو يمثِّل جميع المحارف المراد إزالتها. يمكن استعمال النقطتين ".." لتحديد مجال من الأحرف.

القيم المعادة

تعيد هذه الدالة السلسلة النصيَّة str بعد أن تزيل جميع المسافات البيضاء أو المحارف المحدَّدة ضمن المعامل الاختياري character_mask. إن لم يُمرَّر المعامل السابق، فستزيل الدالة المحارف التالية:

• " ": محرف الفراغ وهو المحرف 32 (0x20) في الجدول ASCII.
• "‎\t": محرف مسافة الجدولة (tab) وهو المحرف 9 (0x09) في جدول ASCII.
• "‎\n": محرف سطر جديد وهو المحرف 10 (0x0A) في جدول ASCII.
• "‎\r": محرف العودة إلى بداية السطر (carriage return) وهو المحرف 13 (0x0D) في جدول ASCII.
• "‎\0": المحرف NUL وهو المحرف 0 (0x00) في الجدول ASCII.
• "‎\x0B": محرف مسافة الجدولة العموديَّة (vertical tab) وهو المحرف 11 (0x0B) في جدول ASCII.

أمثلة

المثال 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);

//ونهايته $binary من بداية قيمة المتغير ASCII إزالة محارف التحكم الموجودة في جدول

// أي من المحرف 0 وحتى المحرف 31

$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()‎: تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من بداية ونهاية السلسلة النصيَّة المررَّة إليها.
• rtrim()‎: تزيل المسافات البيضاء (whitespace) (أي جميع محارف الفراغات) أو أي محرف آخر من نهاية السلسلة النصيَّة المررَّة إليها.

مصادر

• صفحة الدالة ltrim في توثيق PHP الرسمي.