Функция __RETURN_ZERO() │ WP 3.0.0

Функция __return_zero() просто возвращает значение 0. Это вспомогательная функция WordPress, которая полезна для использования в фильтрах.

Похожие вспомогательные функции:

• __return_false() — возвращает false (ложь).
• __return_true() — возвращает true (истина).
• __return_empty_array() — возвращает пустой массив: array().
• __return_zero() — возвращает число 0.
• __return_null() — возвращает NULL (ничто).
• __return_empty_string() — возвращает пустую строку: ''.

Внутренняя функция

Эта функция предназначена для работы непосредственно в ядре WordPress. Использовать её в своём коде не рекомендуется.

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

• Время выполнения функции: 0.000001 секунды (по скорости света).
• 50000 вызовов — 0.00 секунды (по скорости света).
• PHP 7.1.11, WordPress 4.9.7.

Хуки

Эта функция не имеет хуков.

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

Функция возвращает целое число (Int) со значением 0.

Применение

Для использования функции напишите:

__return_zero();

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

Пример 1: Использование функции в фильтре

Предположим, нам нужно вернуть 0 в фильтре example_filter. Код будет выглядеть так:

add_filter( 'my_filter', '__return_zero' );

Альтернативно, вы можете написать это другим способом:

// Анонимная функция (PHP 5.3+)
add_filter( 'my_filter', function(){ return 0; } );

// Или с использованием зарегистрированной функции
add_filter( 'my_filter', 'my_return_function' );
function my_return_function(){
    return 0;
}

Хранение и изменения

Изменения

Функция была введена в WordPress начиная с версии 3.0.0.

Код функции

Далее приведён код функции из файла wp-includes/functions.php:

function __return_zero() {
return 0;
}

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

Другие вспомогательные функции, которые могут быть полезны:

• __return_empty_array()
• __return_empty_string()
• __return_false()
• __return_null()
• __return_true()

Другие вспомогательные функции

Кроме того, вы можете изучить и другие вспомогательные функции, которые предлагает WordPress:

• array_key_first()
• array_key_last()
• build_query()
• get_page_hierarchy()
• wp_random()

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