Informix DataBlade API Programmer's Manual DataBlade API Function Descriptions

The mi_collection_create() function creates a collection.

MI_COLLECTION *mi_collection_create(conn, typeid_ptr)

MI_CONNECTION *conn;

MI_TYPEID *typeid_ptr;

conn	is a pointer to the connection descriptor that a previous call to mi_open(), mi_server_connect(), or mi_server_reconnect() established.
typeid_ptr	is a pointer to the type identifier for the element type of the new collection.

Valid in Client LIBMI Application?	Valid in User-Defined Routine?
Yes	Yes

The mi_collection_create() function creates a new collection structure whose element type is the data type that the typeid_ptr type identifier references. This function is a constructor function for the collection structure. To access elements of the collection, you must first open the collection with the mi_collection_open() function.

The mi_collection_create() function allocates a new collection structure in the current memory duration.

See the descriptions of the following functions: mi_collection_close(), mi_collection_copy(), mi_collection_delete(), mi_collection_fetch(), mi_collection_free(), mi_collection_insert(), mi_collection_open(), mi_collection_update(), mi_typestring_to_id(), and mi_typename_to_id().

For a description of collections, see Collections.