__return_empty_array() WP 3.0.0
Simply returns an empty array: array(). Helper function of WordPress.
Useful for returning an empty array to filters easily.
All such helper functions:
__return_false() — returns false.
__return_true() — returns true.
__return_empty_array() — returns an empty: array().
__return_zero() — returns the number 0.
__return_null() — returns NULL.
__return_empty_string() — returns an empty string: ''.
1 time = 0.000001s = speed of light | 50000 times = 0.01s = speed of light | PHP 7.1.11, WP 4.9.7
No Hooks.
Return
Array. Empty array.
Usage
__return_empty_array() // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore;
Examples
#1 Demonstrate the use of
Suppose that in the filter 'my_filter' we need to always return an empty array():
add_filter( 'my_filter', '__return_empty_array' );
The same can be written so:
// example of anonymous function add_filter( 'my_filter', create_function('','return array();') ); // or so for php 5.3+ add_filter( 'my_filter', function(){ return array(); } ); // or so, with the registration function add_filter( 'my_filter', 'my_return_function' ); function my_return_function(){ return array(); }
Changelog
Since 3.0.0 | Introduced. |
Code of __return_empty_array() return empty array WP 5.6
function __return_empty_array() { // phpcs:ignore WordPress.NamingConventions.ValidFunctionName.FunctionDoubleUnderscore,PHPCompatibility.FunctionNameRestrictions.ReservedFunctionNames.FunctionDoubleUnderscore
return array();
}Related Functions
From tag: __return (helper functions)
More from category: Helper Functions
- build_query()
- get_page_hierarchy()
- get_temp_dir()
- human_readable_duration()
- is_email()
- is_php_version_compatible()
- is_serialized()
- is_serialized_string()
- is_wp_version_compatible()
- map_deep()
- maybe_serialize()
- maybe_unserialize()
- path_join()
- seems_utf8()
- stripslashes_deep()
- timer_stop()
- urlencode_deep()
- wp_array_slice_assoc()
- wp_basename()
- wp_debug_backtrace_summary()
- wp_doing_ajax()
- wp_extract_urls()
- wp_filter_object_list()
- wp_generate_uuid4()
- wp_html_split()
- wp_is_json_request()
- wp_is_numeric_array()
- wp_is_uuid()
- wp_json_encode()
- wp_kses_array_lc()
- wp_kses_hair()
- wp_kses_uri_attributes()
- wp_list_filter()
- wp_list_pluck()
- wp_list_sort()
- wp_make_link_relative()
- wp_mkdir_p()
- wp_normalize_path()