Aperio Documentation > RPG Procedures Reference > Response Procedures > respAddValue()

respAddValue()

This is general procedure which adds value for existing field.

Parameter	Type		Description
ptr	POINTER	Mandatory	Pointer to field
valueType	1A	Mandatory	Type of value
numericValue	30P 9	Optional, can be omit	Numeric value provided if valueType is set to “N”
stringValue	1024A VARYING, VARSIZE	Optional, can be omit	String value provided if valueType is set to “S”
json_ptr	POINTER	Optional, can be omit	Pointer to JSON object provided if valueType is set to “J”
UCS2value	1024C VARYING, VARSIZE	Optional, can be omit	UCS2 string value if valueType is set to “U”
object_ptr	POINTER	Optional, can be omit	The pointer to response element object provided if valueType is set to “R”
blob_ptr	POINTER	Optional, can be omit	The pointer to Blob data provided if valueType is set to “B”. Can be provided if value type is “J”
blob_len	10U 0	Optional	The length in bytes of Blob data provided if valueType is set to “B” or “J”

Following valueTypes are supported:

S - String
N - Numeric
T - True
F - False
0 - null
J - JSON String
U - UCS2 String
O - JSON Object
R - Response Element Object
B - Blob

The procedure returns pointer of field. If procedure can’t add value, then returns null.

Examples:

xxPtr = respAddField('data': 'exampleField');
respAddValue(xxPtr: 'S': *omit: 'text');

respAddValue(xxPtr: 'N': 1234,56);

respAddValue(xxPtr: 'T');

respAddValue(xxPtr: 'F');

respAddValue(xxPtr: '0');

respAddValue(xxPtr: 'J': *omit: *omit: json_ptr, *omit, *omit, json_ptr, json_len);

respAddValue(xxPtr: 'U': *omit: *omit: *omit: UCS2Variable);

respAddValue(xxPtr: 'O': *omit: *omit: Object_ptr);

respAddValue(xxPtr: 'R': *omit: *omit: *omit: *omit: ResponseObject_ptr);

respAddValue(xxPtr: 'B': *omit: *omit: *omit: *omit: *omit: valuePtr: valueLength);