REST_IS_BOOLEAN() │ WP 4.7.0

Функция REST_IS_BOOLEAN() определяет, является ли заданное значение логическим (boolean) или похожим на логическое. Она не обращает внимания на тип значения и, как и в PHP, 1 равен true (истина), а 0 равен false (ложь).

Производительность

• Время выполнения один раз: 0.000001 сек (скорость света)
• Время выполнения 50000 раз: 0.02 сек (скорость света)
• Используемая версия PHP: 7.1.11, версия WP: 4.9.8

Как работает функция

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

Функция возвращает:

• true, если значение является логическим или похоже на логическое.
• false, если нет.

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

rest_is_boolean( $maybe_bool );

• $maybe_bool (обязательно): значение, которое нужно оценить (может быть true, false или строкой).

Примеры

Проверка, являются ли значения логическими или похожими на логические

var_dump( rest_is_boolean( true ) );        // true
var_dump( rest_is_boolean( false ) );       // true
var_dump( rest_is_boolean( 'false' ) );     // true
var_dump( rest_is_boolean( 'true' ) );      // true
var_dump( rest_is_boolean( 'FalSe' ) );     // true
var_dump( rest_is_boolean( 'trUe' ) );      // true
var_dump( rest_is_boolean( 1 ) );           // true
var_dump( rest_is_boolean( 0 ) );           // true
var_dump( rest_is_boolean( '1' ) );         // true
var_dump( rest_is_boolean( '0' ) );         // true

Следующие вызовы вернут false:

var_dump( rest_is_boolean( 'trueFalse' ) ); // false
var_dump( rest_is_boolean( 'anyString' ) ); // false
var_dump( rest_is_boolean( 1.0 ) );         // false
var_dump( rest_is_boolean( 2 ) );           // false
var_dump( rest_is_boolean( -1 ) );          // false
var_dump( rest_is_boolean( -2 ) );          // false
var_dump( rest_is_boolean( '-1' ) );        // false
var_dump( rest_is_boolean( '2' ) );         // false

Измене��ия

• Начало использования функции: версия 4.7.0.

Исходный код функции

function rest_is_boolean( $maybe_bool ) {
    if ( is_bool( $maybe_bool ) ) {
        return true;
    }

    if ( is_string( $maybe_bool ) ) {
        $maybe_bool = strtolower( $maybe_bool );

        $valid_boolean_values = array(
            'false',
            'true',
            '0',
            '1',
        );

        return in_array( $maybe_bool, $valid_boolean_values, true );
    }

    if ( is_int( $maybe_bool ) ) {
        return in_array( $maybe_bool, array( 0, 1 ), true );
    }

    return false;
}

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

Вот некоторые функции, которые могут быть полезны при работе с логическими значениями:

• is_email()
• validate_file()
• wp_http_validate_url()
• wp_validate_redirect()

Функции REST API:

• get_rest_url()
• register_rest_field()
• register_rest_route()
• rest_ensure_response()
• rest_output_link_wp_head()
• rest_sanitize_array()
• rest_stabilize_value()
• rest_url()
• WP_Application_Passwords::create_new_application_password()
• wp_is_application_passwords_available()
• wp_is_rest_endpoint()

Эта статья охватывает все ключевые аспекты функции REST_IS_BOOLEAN(), помогая вам понять, как она работает и как использовать её в вашем проекте на WordPress.