GetItemBlob

Syntax 1: GetItemBlob (ItemHandle)

Syntax 2: GetItemBlob (ParentItemHandle, Key)

Syntax 3: GetItemBlob (ItemPath)

Syntax 1

Description

Gets the value of the item whose type is blob.

Applies to

JSONParser objects

Syntax

objectname.GetItemBlob ( ItemHandle )

Argument

Description

objectname

The name of the JSONParser object whose item value you want to obtain.

ItemHandle

A long whose value is the item handle of JsonStringItem type.


Return value

Blob.

Returns the blob value of the item if it succeeds; if any argument's value is null, returns null; if an error occurs, the SystemError event will be triggered.

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 third item:

JsonParser lnv_JsonParser
String ls_Json
Blob lblb_image
Long ll_RootObject, ll_item
lnv_JsonParser = Create JsonParser

ls_Json = '{"id":1001, "name": "evan", "Blob":"dABoAGkAcwAgAGkAcwAgAGIAbABvAGIA"}'

lnv_JsonParser.LoadString(ls_Json)
ll_RootObject = lnv_JsonParser.GetRootItem()
ll_item = lnv_JsonParser.GetChildItem(ll_RootObject, 3)
lblb_image = lnv_JsonParser.GetItemBlob(ll_item)

Syntax 2

Description

Gets the value of the item whose type is blob.

Applies to

JSONParser objects

Syntax

objectname.GetItemBlob ( ParentItemHandle, Key )

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.

Key

A string whose value is the key of the child item of JsonStringItem type.


Return value

Blob.

Returns the blob value of the child item if it succeeds; if any argument's value is null, returns null; if an error occurs, the SystemError event will be triggered.

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 "image" item:

JsonParser lnv_JsonParser
String ls_Json
Blob lblb_image
Long ll_RootObject, ll_item 
lnv_JsonParser = Create JsonParser

ls_Json = '{"id":1001, "name": "evan", "image": "=F923LDF%$2KS0238D8G……BASE64"}'

lnv_JsonParser.LoadString(ls_Json)
ll_RootObject = lnv_JsonParser.GetRootItem()
lblb_image = lnv_JsonParser.GetItemBlob(ll_item, "image")

Syntax 3

Description

Gets the value of the item whose type is blob.

Applies to

JSONParser objects

Syntax

objectname.GetItemBlob ( ItemPath )

Argument

Description

objectname

The name of the JSONParser object whose item value you want to obtain.

ItemPath

A string whose value is the path of the item of JsonStringItem type. If there is a multi-dimensional array, use the number to indicate the order of the array elements. If a key name contains "/", use the escape character "~~/" to replace "/".


Return value

Blob.

Returns the blob value of the item if it succeeds; if any argument's value is null, returns null; if an error occurs, the SystemError event will be triggered.

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 third item according to its item path:

JsonParser lnv_JsonParser
String ls_Json, ls_Path
Blob lblb_image
lnv_JsonParser = Create JsonParser

ls_Json = '{"id":1001, "name":"evan", "Blob":"dABoAGkAcwAgAGkAcwAgAGIAbABvAGIA"}'

lnv_JsonParser.LoadString(ls_Json)
ls_Path = "/Blob"
lblb_image = lnv_JsonParser.GetItemBlob(ls_Path)

See also

GetItemArray

GetItemArrayJSONString

GetItemBoolean

GetItemByPath

GetItemDate

GetItemDateTime

GetItemDecimal

GetItemNumber

GetItemObject

GetItemObjectJSONString

GetItemString

GetItemTime

GetItemType

GetNumberType