DATASET

10.8, PLBCMP GUI Only

The DATASET object is implemented as a key-value store that is a simple NoSQL in memory database. The data is stored in memory as a linked list of data items where each item requires a unique 'key'. The 'value' data for each item can be plain text, JSON, XML, binary data, HTML, etc... The DATASET object has properties and methods that allow a PL/B program to maintain and manage program data items as needed for the application. The declaration syntax of a DATASET is as follows:

(1)	[label]	DATASET	[%\|^][arraysize]
(2)	[label]	DATASET	^,{target}
(3)	[label]	DATASET	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

The DATASET is supported in CREATE, GETPROP, and SETPROP instructions.
If the DATASET object is not created when a method is executed, it is implicitly created by the method. When the DATASET object is implicitly created, all of the properties for the object are set to their default states.

See Also: Object Definitions