Метод truncate

Метод truncate класса UnicodeString обрезает строку до указанной длины. Первым параметром передаётся максимальная длина строки в символах. Вторым необязательным параметром передаётся суффикс, который добавляется к обрезанной строке. По умолчанию суффикс равен '...'. Метод возвращает новый объект UnicodeString и не изменяет исходный.

Синтаксис

$res = u('...')->truncate(length, suffix);

Пример

Давайте обрежем строку до 5 символов:

<?php
	use Symfony\Component\String\UnicodeString;
	
	$str = new UnicodeString('abcde article hello');
	$res = $str->truncate(5);
	
	echo $res;
?>

Результат выполнения кода:

"ab..."

Пример

Давайте передадим собственный суффикс вторым параметром:

<?php
	use Symfony\Component\String\UnicodeString;
	
	$str = new UnicodeString('abcde article hello');
	$res = $str->truncate(5, '!');
	
	echo $res;
?>

Результат выполнения кода:

"abcd!"

Пример

Если длина строки не превышает заданное значение, строка возвращается без изменений:

<?php
	use Symfony\Component\String\UnicodeString;
	
	$str = new UnicodeString('abcde');
	$res = $str->truncate(10);
	
	echo $res;
?>

Результат выполнения кода:

"abcde"

Пример

Давайте обрежем строку с многобайтовыми символами:

<?php
	use Symfony\Component\String\UnicodeString;
	
	$str = new UnicodeString('привет мир hello');
	$res = $str->truncate(6);
	
	echo $res;
?>

Результат выполнения кода:

"при..."

Смотрите также

класс UnicodeString,
который представляет Unicode-строку
метод slice,
который вырезает часть строки
метод splice,
который заменяет часть строки
метод chunk,
который разбивает строку на части