# Функция __RETURN_EMPTY_ARRAY()
Функция __return_empty_array()
бы��а добавлена в WordPress версии 3.0.0 и просто возвращает пустой массив: array()
. Эта функция является вспомогательной и служит для упрощения работы с фильтрами в WordPress.
## Зачем использовать эту функцию?
Функция полезна, когда нужно быстро вернуть пустой массив с помощью фильтра. Например, если вам нужно, чтобы какой-то фильтр всегда возвращал пустой массив, вы можете использовать именно эту функцию.
### Другие вспомогательные функции
В WordPress есть несколько других вспомогательных функций, которые работают аналогичным образом:
- __return_false()
— возвращает false
.
- __return_true()
— возвращает true
.
- __return_zero()
— возвращает число 0.
- __return_null()
— возвращает NULL
.
- __return_empty_string()
— возвращает пустую строку: ''
.
## Важные моменты
Это внутренняя функция, что значит, что она предназначена для использования в основном коде WordPress. Рекомендуется не использовать её в вашем коде, если это не необходимо.
### Производительность
- Время выполнения функции: 0.000001 секунды (при первом вызове).
- Если вызвать функцию 50000 раз, это займет 0.01 секунды.
## Возвращаемое значение
Функция возвращает:
- **Массив**: пустой массив.
## Применение
Вызов функции:
```php
__return_empty_array();
Пример использования
Допустим, вам необходимо всегда возвращать пустой массив в фильтре my_filter
. Вы можете сделать это следующим образом:
add_filter( 'my_filter', '__return_empty_array' );
Также это можно записать с помощью анонимной функции:
// Пример с анонимной функцией
add_filter( 'my_filter', create_function('', 'return array();') );
// Или так (для PHP 5.3+)
add_filter( 'my_filter', function() { return array(); } );
// Либо с помощью зарегистрированной функции
add_filter( 'my_filter', 'my_return_function' );
function my_return_function() {
return array();
}
Примечание
Всегда старайтесь использовать рекомендации и стандарты кода, так как это обеспечит лучшее взаимодействие вашего кода с ядром WordPress и другими плагинами.
Изменения
- С версии: 3.0.0 функция была добавлена в WordPress.
Код функции
Вот код функции __return_empty_array()
:
function __return_empty_array() {
return array();
}
Связанные функции
Функция имеет несколько аналогов, которые также могут быть полезны:
__return_empty_string()
__return_false()
__return_null()
__return_true()
__return_zero()
Если у вас есть вопросы или вы хотите добавить свой пример использования, не стесняйтесь делиться!