21.10 GET_BOOLEANファンクション

このファンクションは、ブール数値を戻します。

構文

APEX_JSON.GET_BOOLEAN (
    p_path             IN VARCHAR2,
    p0                 IN VARCHAR2 DEFAULT NULL,
    p1                 IN VARCHAR2 DEFAULT NULL,
    p2                 IN VARCHAR2 DEFAULT NULL,
    p3                 IN VARCHAR2 DEFAULT NULL,
    p4                 IN VARCHAR2 DEFAULT NULL,
    p_default          IN BOOLEAN  DEFAULT NULL,
    p_values           IN t_values DEFAULT g_values )
RETURN BOOLEAN;

パラメータ

表21-5 GET_BOOLEANファンクションのパラメータ

パラメータ	説明
p_path	p_valuesへの索引。
p[0-4]	p_pathの各%NをpNで置き換え、i-th %sまたは%dをすべてp[i-1]で置き換えます。
p_default	メンバーが存在しない場合のデフォルト値。
p_values	解析されたJSONメンバー。デフォルトは、g_valuesです。

戻り値

表21-6 GET_BOOLEANファンクションの戻り値

戻り値	説明
TRUE	指定されたパスの位置にある値。
FALSE	指定されたパスの位置にある値。
NULL	指定されたパスの位置にある値。
VALUE_ERROR	p_values(p_path)がブール値ではない場合に、このエラーが発生します。

例

この例では、JSON文字列を解析し、位置にあるブール値を出力します。

DECLARE 
    j apex_json.t_values; 
BEGIN 
    apex_json.parse(j, '{ "items": [ 1, 2, { "foo": true } ] }'); 
    if apex_json.get_boolean(p_path=>'items[%d].foo', p0=>3,p_values=>j) then 
        dbms_output.put_line('items[3].foo is true'); 
END IF; 
END;