Функция __return_false() в WordPress: примеры использования и описание

# __RETURN_FALSE() │ WP 3.0.0

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

Условно говоря, её используют в фильтрах, когда нужно указать функцию, которая всегда возвращает false.

## Вспомогательные функции

В WordPress есть несколько подобных вспомога��ельных функций:

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

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

**Время выполнения**: 1 раз — 0.000001 сек (скорость света) | 50000 раз — 0.00 сек (скорость света) | PHP 7.1.11, WP 4.9.7

**Нет хуков.**

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

false.

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

Чтобы вызвать функцию, достаточно написать:

```php
__return_false();

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

Пример 1: Возврат false в фильтре

Предположим, у нас есть фильтр 'show_admin_bar', и мы хотим вернуть false для этого фильтра. Для этого можно написать специальную функцию или использовать вспомогательную функцию __return_false():

add_filter( 'show_admin_bar', '__return_false' );

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

add_filter( 'show_admin_bar', function() { return false; } );

Или можно зарегистрировать свою функцию в PHP:

add_filter( 'show_admin_bar', 'my_return_function' );
function my_return_function() {
    return false;
}

Добавьте свой пример

Заметки

• См. также: __return_true()

Журнал изменений

С версии 3.0.0 — Введена.

Код функции

Функция __return_false() выглядит так:

function __return_false() {
return false;
}

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

• __return_empty_array()
• __return_empty_string()
• __return_null()
• __return_true()
• __return_zero()

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

• array_key_first()
• array_key_last()
• wp_array_slice_assoc()
• wp_basename()
• wp_rand()

В этой версии статьи я попытался сделать текст более доступным для начинающих пользователей WordPress, используя простые слова и пояснения для некоторых терминов. Код оставлен без изменений, чтобы пользователи могли легко его использовать.