rest_sanitize_array()
Перетворює передане значення індексний масив. Якщо перетворення неможливо повернути пустий масив.
Неіндексний масив перетворитися на індексний.
Алгоритм роботи:
Перевіряє, чи є передане значення скалярним (за допомогою PHP функції is_scalar() ). Якщо є, воно обробляється функцією wp_parse_list() і результат повертається.
Скалярні змінні – це змінні з типами int , float , string та bool . Типи array , об’єкт і ресурс не є скалярними.
Якщо передано не скаляр і масив ( object , resource тощо.), то функція поверне порожній масив.
- Якщо передано масив, то функція збере з його значень індексний масив і поверне його.
Працює на основі:
wp_parse_list()
wp_parse_list()
Хуків немає.
Повертає
Массив. Масив (порожній чи нумерований).
Використання
rest_sanitize_array( $maybe_array );-
$maybe_array
(змішаний) (обов’язковий) - Значення перетворення.
Приклади
#1 Варіанти роботи функції
rest_sanitize_array( 'Вова,Миша,Тимур,Дима' );
// Функція поверне
Array (
[0] => Вова
[1] => Мишко
[2] => Тимур
[3] => Діма
)
rest_sanitize_array([
'name' => 'Ольга',
'age' => 5
]);
// Функція поверне
Array (
[0] => Ольга
[1] => 5
)
список змін
| З версії 5.5.0 | Введено. |
Код rest_sanitize_array() rest sanitize array WP 6.0.2
function rest_sanitize_array( $maybe_array ) {
if ( is_scalar ( $ maybe_array ) ) {
return wp_parse_list( $maybe_array );
}
if ( ! is_array( $maybe_array ) ) {
return array();
}
// Normalize to numeric array so nothing unexpected is in the keys.
return array_values( $maybe_array );
}