37.22 GET_VARCHAR2 Function
This function returns a varchar2 member value. This function converts boolean and number values to varchar2 values.
Syntax
APEX_JSON.GET_VARCHAR2 (
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 VARCHAR2;
Parameters
Table 37-29 GET_VARCHAR2 Parameters
Parameter | Description |
---|---|
p_path |
Index into p_values .
|
p[0-4] |
Each %N in p_path is replaced by pN and every i-th %s or %d is replaced by the p[i-1] .
|
p_default |
The default value if the member does not exist. |
p_values |
Parsed JSON members. The default is g_values .
|
Returns and Raised Errors
Table 37-30 GET_VARCHAR2 Function Returns and Raised Errors
Return | Description |
---|---|
VARCHAR2 |
This is the value at the given path position. |
VALUE_ERROR |
Raises this error if p_values(p_path) is not an array or object.
|
Example
This example parses a JSON string and prints the value at a position.
DECLARE
j apex_json.t_values;
BEGIN
apex_json.parse(j, '{ "items": [ 1, 2, { "foo": 42 } ] }');
dbms_output.put_line(apex_json.get_varchar2(p_path=>'items[%d].foo',p0=> 3,p_values=>j));
END;
Parent topic: APEX_JSON