__return_empty_string() WP 3.7.0
Просто возвращает пустую строку: ''. Вспомогательная функция 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 5.8
function __return_empty_string() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
return '';
}