Syntax 1: GetItemDecimal (Long ItemHandle)
Syntax 2: GetItemDecimal (long ParentItemHandle, string szKey)
Syntax 3: GetItemDecimal (string szPath)
Description
Gets the value of the item whose type is decimal.
Applies to
Syntax
objectname.GetItemDecimal (Long ItemHandle)
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose item value you want to obtain. |
|
ItemHandle |
A long whose value is the handle of the item of JsonNumberItem type. |
Return value
Decimal.
Returns the decimal value of the item if it succeeds; if any argument's value is null, returns null; if an error occurs, throws the exception.
Usage
If the item value is null, this function will throw an error, therefore, it is recommended that before executing this function, call GetItemType to check if the item value is null. See example 2 in GetItemArray.
Examples
This example gets the decimal value of the first item:
JsonParser lnv_JsonParser
String ls_Json
Long ll_RootObject, ll_item
Decimal ld_MessageID
lnv_JsonParser = Create JsonParser
ls_Json = '{"MessageID": 3.14159265357, "parm":"test"}'
lnv_JsonParser.LoadString(ls_Json)
ll_RootObject = lnv_JsonParser.GetRootItem()
ll_item = lnv_JsonParser.GetChildItem(ll_RootObject, 1)
ld_MessageID = lnv_JsonParser.GetItemDecimal(ll_item)
Description
Gets the value of the item whose type is decimal.
Applies to
Syntax
objectname.GetItemDecimal (long ParentItemHandle, string szKey)
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose child item value you want to obtain. |
|
ParentItemHandle |
A long whose value is the handle of the parent item of JsonObjectItem type. |
|
szKey |
A string whose value is the key of the child item of JsonNumberItem type. |
Return value
Decimal.
Returns the decimal value of the child item if it succeeds; if any argument's value is null, returns null; if an error occurs, throws the exception.
Usage
If the item value is null, this function will throw an error, therefore, it is recommended that before executing this function, call GetItemType to check if the item value is null. See example 2 in GetItemArray.
Examples
This example gets the value of the "MessageID" item:
JsonParser lnv_JsonParser
String ls_Json
Long ll_RootObject
Decimal ld_MessageID
lnv_JsonParser = Create JsonParser
ls_Json = '{"MessageID": 3.14159265357, "parm":"test"}'
lnv_JsonParser.LoadString(ls_Json)
ll_RootObject = lnv_JsonParser.GetRootItem()
ld_MessageID = lnv_JsonParser. GetItemDecimal (ll_RootObject, "MessageID")
Description
Gets the value of the item whose type is decimal.
Applies to
Syntax
objectname.GetItemDecimal (string szPath)
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose item value you want to obtain. |
|
szPath |
A string whose value is the path of the item of JsonNumberItem type. If there is a multi-dimensional array, use the number to indicate the order of the array. If a key name contains "/", use the escape character "~~/" to replace "/". |
Return value
Decimal.
Returns the decimal value of the item if it succeeds; if any argument's value is null, returns null; if an error occurs, throws the exception.
Usage
If the item value is null, this function will throw an error, therefore, it is recommended that before executing this function, call GetItemType to check if the item value is null. See example 2 in GetItemArray.
Examples
This example gets the value of the first item according to its item path:
JsonParser lnv_JsonParser
String ls_Json, ls_Path
Decimal ld_MessageID
lnv_JsonParser = Create JsonParser
ls_Json = '{"MessageID": 3.14159265357, "parm":"test"}'
lnv_JsonParser.LoadString(ls_Json)
ls_Path = "/MessageID"
ld_MessageID = lnv_JsonParser.GetItemDecimal(ls_Path)
See also
