JsonArraySet(json, int, json)

From NWN Lexicon
Jump to navigationJump to search
Note: This article documents Neverwinter Nights: Enhanced Edition new content or changes/updates/fixes to 1.69 functions. These are all listed under the category and patches pages.

Returns a modified copy of jArray with position nIndex set to jValue.

json JsonArraySet(
    json jArray,
    int nIndex,
    json jValue
);


Parameters

jArray
The json Array to modify.
nIndex
The index to set for a value.
jValue
The json value to set.


Description

Returns a modified copy of jArray with position nIndex set to jValue.


Remarks

Returns a json null value if jArray is not actually an array, with JsonGetError filled in. Returns a json null value if nIndex is out of bounds, with JsonGetError filled in.


Version

This function was added in 1.85.8193.31 of NWN:EE.


Example

void main() 
{
    json jArray = JsonParse("{[1, 2, 5, 4]}");
	
    // Set index 2 (value 5) to 3. We assign the result of the function to the same variable.
    jArray = JsonArraySet(jArray, 2, JsonInt(3));
    WriteTimestampedLogEntry(JsonDump(jArray)); // {[1, 2, 3, 4]}
}

See Also

functions:

JSON Functions