InsertProperty Method

This method inserts the specified name and value at the selected position.

Syntax

• C++
• Objective-C
• C

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

Unicode (Windows)
INT InsertProperty(LPCWSTR lpszName, LPCWSTR lpszValue, INT iValueType, INT iPosition);

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

#define MID_JSON_INSERTPROPERTY 10

IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_JSON_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

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

The Name parameter specifies the name of the property.

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.)