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 );
}