STR_ENDS_WITH() │ WP 5.9.0

Функция STR_ENDS_WITH() выполняет проверку, заканчивается ли одна строка (называемая "страна") на другую (называемую "игла"). Эта проверка чувствительна к регистру, то есть учитывает, большие ли буквы или маленькие.

Как это работает

Функция проверяет, заканчивается ли строка $haystack на подстроку $needle. Если заканчивается — возвращает true, если нет — возвращает false.

• Время выполнения: 1 раз — 0.000001 секунды (очень быстро) | 50000 раз — 0.01 секунды (тоже быстро)

Синтаксис

str_ends_with( $haystack, $needle );

Параметры функции

• $haystack (строка) — строка, в которой мы ищем. Этот параметр обязателен.
• $needle (строка) — подстрока, которую мы ищем в $haystack. Этот параметр также обязателен.

Примеры использования

Пример 1

str_ends_with( 'ABC', 'C' ); // вернёт true

Пример 2

str_ends_with( 'ABC', 'A' ); // вернёт false

Пример 3 (Учёт регистра)

str_ends_with( 'ABC', 'c' ); // вернёт false

Пример 4 (Проверка на пустую строку)

str_ends_with( 'abc', '' ); // вернёт true

Что возвращает функция

• true — если $haystack заканчивается на $needle
• false — если нет

Как это работает под капотом

Ниже приведён код функции str_ends_with:

function str_ends_with( $haystack, $needle ) {
if ( '' === $haystack ) {
return '' === $needle;
}

$len = strlen( $needle );

return substr( $haystack, -$len, $len ) === $needle;

}

Как работает код:

1. Проверяет, пустая ли строка $haystack. Если да, то возвращает true, если $needle тоже пустая.
2. Вычисляет длину подстроки $needle.
3. Сравнивает конец строки $haystack с подстрокой $needle. Если совпадает, возвращает true, в противном случае — false.

Примечания

• Функция STR_ENDS_WITH доступна с версии WordPress 5.9.0.

Эта функция полезна для различных проверок строк в WordPress и других проектах PHP.