Ltrim: примеры (PHP)

Использование ltrim для обработки строк в PHP
Раздел: Работа со строками
ltrim(string $string, string $characters = " \t\n\r\0\x0B"): string

Функция ltrim в PHP

Функция ltrim удаляет пробельные или другие заданные символы из начала строки. Она применяется для очистки пользовательского ввода, обработки данных из внешних источников и нормализации строк перед сравнением или сохранением.

Аргументы функции
  • $string (обязательный) – исходная строка для обработки.
  • $characters (опциональный) – набор символов для удаления. Если параметр опущен, функция удаляет пробельные символы: пробел, табуляцию, перевод строки, возврат каретки, нулевой байт и вертикальную табуляцию.
Примеры ltrim
Удаление пробелов
echo ltrim('   текст');
текст
Удаление заданных символов
echo ltrim('/путь/', '/');
путь/
Удаление набора символов
echo ltrim('\t\n\r текст', " \t\n\r\0\x0B");
текст
Обработка нумерованного списка
echo ltrim('123. Пункт', '0123456789. ');
Пункт
Похожие функции PHP

Удаляет символы с обоих концов строки. Подходит для полной очистки строки.

Удаляет символы только с конца строки. Используется, когда нужно сохранить начальные пробелы.

preg_replace

Позволяет удалять символы по регулярному выражению. Применяется для сложных шаблонов удаления, но работает медленнее.

Типичные ошибки
Ожидание удаления символов в середине строки
echo ltrim('abc123abc', 'abc');
123abc

Функция удаляет символы только из начала строки, 'abc' в середине остается.

Неправильный порядок символов
echo ltrim('123abc', '321');
abc

Функция удаляет символы '3','2','1' из начала, а не подстроку '321'.

Использование null вместо строки
echo ltrim(null, 'x');
PHP Warning: ltrim(): Passing null to parameter...

Начиная с PHP 8.1 передача null вызывает предупреждение.

Изменения в PHP
PHP 8.1

Передача параметра null в аргумент $string вызывает предупреждение об устаревании. Теперь ожидается строка.

Ранние версии

До PHP 4.1.0 второй параметр игнорировался, удалялись только пробелы.

Расширенные примеры
Очистка конфигурационных строк
Пример php
$config = "\n\t\r value=1";\necho ltrim($config);
value=1
Удаление префиксов валют
Пример php
$price = '$$$199';\necho ltrim($price, '$');
199
Обработка CSV данных
Пример php
$csvLine = "\t\"значение\",\"другое\"";\n$clean = ltrim($csvLine, " \t");\necho $clean;
"значение","другое"
Чтение выровненного текста
Пример php
$text = "    строка1\n   строка2\n  строка3";\n$lines = explode('\n', $text);\nforeach($lines as $line) {\n    echo ltrim($line)."\n";\n}
строка1\nстрока2\nстрока3
Комбинирование с другими функциями
Пример php
$input = "  ТЕКСТ  ";\n$result = mb_strtolower(ltrim($input));\necho $result;
текст  
Удаление BOM маркера
Пример php
$textWithBom = "\xEF\xBB\xBFтекст";\n$clean = ltrim($textWithBom, "\xEF\xBB\xBF");\necho $clean;
текст
Аналоги в других языках
Python: str.lstrip
text = '   пример'\nprint(text.lstrip())
пример

Метод строки, аналог ltrim. Принимает необязательный аргумент chars.

JavaScript: String.prototype.trimStart
let text = '   текст';\nconsole.log(text.trimStart());
текст

Удаляет пробельные символы с начала. Для удаления других символов нужна замена регулярным выражением.

MySQL: LTRIM
SELECT LTRIM('   запрос');
запрос

Удаляет только пробелы, не поддерживает указание кастомных символов.

C#: String.TrimStart
string result = "   строка".TrimStart();

Работает аналогично, принимает массив символов для удаления.

PHP ltrim function comments

En
Ltrim Strip whitespace (or other characters) from the beginning of a string