reqGet3StateValue()

This procedure retrieves 3-State value for given node string.

ParameterTypeDescription
baseNode1024A VARYING, VARSIZEMandatoryThis parameter is used to pass base node. Currently following base nodes are supproted: “IptorAPI”, “method”, “params”, “messages”, “control”, “id”
node1024A VARYING, VARSIZEOptionalNode name. This parameter is optional. If the structure is more complex then nodes must be divided by colon “:”
patern10i 0 VARSIZEOptionalConversion pattern (see patterns)
valueType1AOptionalReturns type of value (see types of value)
existsNOptionalReturns *ON if value exists, *OFF if value does not exit

Procedure returns character vale depend on pattern (see patterns). In case of error the returned value is ‘ERROR’

Patterns:

patternDesctiption
#true_false_nullconverts JSON true/false/null -> ’true’/‘false’/’null’ return string
#Y_N_BLANKconverts JSON true/false/null -> ‘Y’/‘N’/BLANK return string
#1_0_BLANKconverts JSON true/false/null -> ‘1’/‘0’/BLANK return string

Types of value:

typeDescription
OObject
CCharacter
NNumeric
Ttrue
Ffalse
0null
Eerror
BLANKValue does not exist

Examples:

Xx3State = reqGet3StateValue('params': 'freeOfCharge');

Xx3State = reqGet3StateValue('params': 'freeOfCharge': #Y_N_BLANK);

Xx3State = reqGetBooleanValue('params':'freeOfCharge':#true_false_null);