Obtain collection values
For a collection, the value that the mi_value() and mi_value_by_name() functions return depends on whether the control mode for the query data is text or binary representation.
| Return value | Control mode | Contents of value buffer |
|---|---|---|
| MI_NORMAL_VALUE | Text representation | Null-terminated string that contains the text representation of the collection |
| MI_COLLECTION_VALUE | Binary representation | A pointer to a collection structure (MI_COLLECTION) |
In a DataBlade®
API module,
a collection can be created in either of the following ways:
- A column has a collection type (SET, LIST, or MULTISET) as its data type.
- An item being selected is a collection subquery, which represents a collection.