Метод ensureEnd класса UnicodeString

Метод ensureEnd класса UnicodeString проверяет, заканчивается ли текущая строка указанной подстрокой. Если строка уже заканчивается этой подстрокой, метод возвращает исходную строку без изменений. Если нет - подстрока добавляется в конец строки. Первым параметром передаётся подстрока (суффикс), которой должна заканчиваться строка. Вторым необязательным параметром передаётся флаг $ignoreCase, который включает регистронезависимую проверку.

Синтаксис

public function ensureEnd(string $suffix, bool $ignoreCase = false): static

Пример

Давайте добавим суффикс '.txt' к строке, которая ещё не заканчивается им:

<?php
	use SymfonyComponentStringUnicodeString;
	
	$str = new UnicodeString('article');
	$res = $str->ensureEnd('.txt');
	
	echo $res;
?>

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

"article.txt"

Пример

Если строка уже заканчивается указанной подстрокой, метод вернёт её без изменений:

<?php
	use SymfonyComponentStringUnicodeString;
	
	$str = new UnicodeString('article.txt');
	$res = $str->ensureEnd('.txt');
	
	echo $res;
?>

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

"article.txt"

Пример

Давайте включим регистронезависимую проверку с помощью второго параметра $ignoreCase:

<?php
	use SymfonyComponentStringUnicodeString;
	
	$str = new UnicodeString('article.TXT');
	$res = $str->ensureEnd('.txt', true);
	
	echo $res;
?>

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

"article.TXT"

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

метод ensureStart,
который гарантирует наличие префикса в начале строки
метод endsWith,
который проверяет, заканчивается ли строка подстрокой
метод startsWith,
который проверяет, начинается ли строка с подстроки
класс UnicodeString,
который представляет Unicode-строку