Функция STR_CONTAINS() │ WP 5.9.0

Функция STR_CONTAINS() позволяет проверить, содержится ли одна строка (называемая "иголка") в другой строке (называемой "сено"). Обратите внимание, что это проверка регистрозависимая, т.е. 'A' и 'a' будут восприниматься как разные символы.

Данная функция проста в использовании и очень быстрая.

Производительность

• При первом запуске выполняется за 0.000001 секунды (быстрее света).
• При выполнении 50000 раз — за 0.0001 секунды.
• Работает на PHP версии 7.4.25 и WordPress 5.9.

Возвращаемое значение

Функция возвращает true или false. Она возвращает true, если "иголка" ($needle) найдена в "сене" ($haystack), в противном случае возвращает false.

Использование

Чтобы использовать STR_CONTAINS(), вызовите функцию следующим образом:

str_contains( $haystack, $needle );

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

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

Вот несколько примеров, которые проиллюстрируют, как работает функция:

1. Поиск подстроки:

   str_contains( 'ABC', 'B' ); // возвращает true

2. Регистрозависимый поиск:

   str_contains( 'ABC', 'c' ); // возвращает false, так как 'c' в нижнем регистре

3. Проверка на пустую строку:

   str_contains( 'abc', '' ); // всегда возвращает true, пустая строка содержится в любой строке

Изменения

Функция была представлена в версии 5.9.0.

Определение функции

Вот как функция реализована в коде:

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

return false !== strpos( $haystack, $needle );

}

Связанные функции

Также существуют другие функции в PHP, которые могут оказаться полезными:

• array_is_list()
• array_key_first()
• array_key_last()
• is_countable()
• is_iterable()
• str_ends_with()
• str_starts_with()
• wp_basename()
• wp_filesize()
• wp_generate_uuid4()
• wp_json_encode()

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

Эта статья должна помочь вам лучше понять, как использовать функцию STR_CONTAINS() в WordPress. Если у вас есть вопросы или вам нужны дополнительные примеры, не стесняйтесь спрашивать!