__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();

Примеры

0

#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 '';
}

Заметки

Список изменений

С версии 3.7.0 Введена.

Код __return_empty_string() WP 6.7.1

function __return_empty_string() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
	return '';
}