__return_empty_string()
Просто возвращает пустую строку: ''. Вспомогательная функция WordPress.
Обычно используется для быстрой записи фильтра:
add_filter('filter_name', '__return_empty_string');
Другие __return_*
функции:
__return_false()
— возвращает логическое false.
__return_true()
— возвращает логическое true.
__return_empty_array()
— возвращает пустой массив: array().
__return_zero()
— возвращает число 0.
__return_null()
— возвращает NULL.
Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.
1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.01 сек (скорость света) | PHP 7.1.11, WP 4.9.7
Хуков нет.
Возвращает
Строку
.
Использование
__return_empty_string();
Примеры
#1 Пример использования
Допустим, нам в фильтре 'my_filter' нужно всегда возвращать пустую строку. Тогда, используем такой код:
add_filter('my_filter', '__return_empty_string');
Другие варианты такой же записи:
// пример анонимной функции add_filter( 'my_filter', create_function('','return "";') ); // или так для php 5.3+ add_filter( 'my_filter', function(){ return ''; } ); // или так, с регистрацией функции add_filter( 'my_filter', 'my_return_function' ); function my_return_function(){ return ''; }
Заметки
- Смотрите: __return_null()
Список изменений
С версии 3.7.0 | Введена. |
Код __return_empty_string() return empty string WP 6.7.1
function __return_empty_string() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore return ''; }