NAME

       rulexdb_remove_this_item - remove sequentially retrieved item from the rulex dictionary

SYNOPSIS

       #include <rulexdb.h>

       int rulexdb_remove_this_item(RULEXDB *rulexdb, int item_type);

DESCRIPTION

       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:

       RULEXDB_LEXBASE
              Remove item from the Implicit dictionary.

       RULEXDB_EXCEPTION
              Remove item from the Explicit dictionary.

       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.

SEE ALSO

       rulexdb_classify(3),     rulexdb_close(3),     rulexdb_dataset_name(3),    rulexdb_discard_dictionary(3),
       rulexdb_discard_ruleset(3),    rulexdb_fetch_rule(3),    rulexdb_lexbase(3),     rulexdb_load_ruleset(3),
       rulexdb_open(3),      rulexdb_remove_item(3),      rulexdb_remove_rule(3),      rulexdb_retrieve_item(3),
       rulexdb_search(3), rulexdb_seq(3), rulexdb_subscribe_item(3), rulexdb_subscribe_rule(3)

AUTHOR

       Igor B. Poretsky <poretsky@mlbox.ru>.

                                                February 21, 2012                    RULEXDB_REMOVE_THIS_ITEM(3)