rulexdb_remove_this_item3
Remove sequentially retrieved item from the rulex dictionary
Usage
#include <rulexdb.h> int rulexdb_remove_this_item(RULEXDB *rulexdb, int item_type);
Overview
The rulexdb_remove_this_item() function removes the last accessed via rulexdb_seq(3) lexical item from the dictionary dataset defined by item_type argument that may accept one of the following values:
|
Remove item from the |
|---|---|
|
Remove item from the |
Note that the data type must be specified explicitly. The value RULEXDB_DEFAULT is not allowed here.
The argument rulexdb references the database to deal with.
Return value
The rulexdb_remove_this_item() function returns RULEXDB_SUCCESS which is zero when specified item was successfully removed, positive value RULEXDB_SPECIAL when this record is already deleted, or negative error code in the case of other failure.
Errors
RULEXDB_FAILURE-
Referenced database has not been opened, internal data structures are corrupted or some other general failure has occurred.
RULEXDB_EPARM-
The argument rulexdb or item_type has an invalid value.
RULEXDB_EACCESS-
The database is not opened for updating or the dataset was never accessed sequentially yet.