libcollection  0.5.0
Macros
Flags used in insert item functions

Macros

#define COL_INSERT_NOCHECK   0
 This is the default mode - no dup checks on insert.
 
#define COL_INSERT_DUPOVER   1
 Check for duplicate name and overwrite. Position arguments are ignored.
 
#define COL_INSERT_DUPOVERT   2
 Check for duplicate name and type and overwrite. Position arguments are ignored.
 
#define COL_INSERT_DUPERROR   3
 Return error EEXIST if the entry with the same name exists.
 
#define COL_INSERT_DUPERRORT   4
 Return error EEXIST if the entry with the same name and type exists.
 
#define COL_INSERT_DUPMOVE   5
 Check for duplicates, overwrite, extract and then move to the position requested.
 
#define COL_INSERT_DUPMOVET   6
 Check for duplicate name and type, overwrite, extract and then move to the position requested.
 

Detailed Description

Flags that can be used with insert functions.

In future can more flags might be added.

NOTE: Use of the duplicate checking flags is costly since it requires a forward look up of the whole collection before the item is inserted. Do not use it until it is absolutely necessary.