InsertValue Method

This method inserts the specified value at the selected position.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int InsertValue(const char* lpszValue, int iValueType, int iPosition);

Unicode (Windows)
INT InsertValue(LPCWSTR lpszValue, INT iValueType, INT iPosition);

- (void)insertValue:(NSString*)value :(int)valueType :(int)position;

#define MID_JSON_INSERTVALUE 11

IPWORKSIOT_EXTERNAL int IPWORKSIOT_CALL IPWorksIoT_JSON_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method inserts a value relative to the element specified by XPath. Before calling this method a valid JSON document must first be loaded by calling Parse.

The Value parameter specifies the value of the property.

The ValueType parameter specifies the type of the value. Possible values are:

• 0 (Object)
• 1 (Array)
• 2 (String)
• 3 (Number)
• 4 (Bool)
• 5 (Null)
• 6 (Raw)

The Position parameter specifies the position of Value relative to the element specified by XPath. Possible values are:

• 0 (Before the current element)
• 1 (After the current element)
• 2 (The first child of the current element)
• 3 (The last child of the current element)

See Save for details.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)