SIS - Application Programmatic Interface, Reference Manual - ICS ...

SIS-Application Programmatic Interface, Reference Manual
int set_del(int sessionID, int set_id)
This function deletes the current node from set set_id.
int set_clear(int sessionID, int set_id)
This function clears the set set_id.
int set_clear_lower(int sessionID, int set_id)
This function clears the set set_id from position 0 up to current position. It
updates the set’s cardinality and sets the current position to the beginning of
the set. It does not delete the element located in current position.
6.5 Read contents of answer sets
The answers of any of the described queries are located in temporary sets. There is a
group of functions to read the information from an answer set. Before first calling any
of these functions to read the objects of an answer set A the pointer of this set must be
reset at the first item of the set with the reset_set() function.
Most of the following functions operate like this: when called, they give the
answer for the next object in the set they apply on and return APISucc(0). If any
error occurred or end of set reached they return APIFail(-1).
int return_nodes(int sessionID, int set_id, l_name cls)
Return the logical name cls of the next object in set set_id.
int return_edge_nodes(int sessionID, int *sysid, l_name node)
Return the system identifier sysid and the logical name node of the next object
in edge_set. (See Section 6.3.6 for definition of the edge_set).
int return_full_nodes(int sessionID, int set_id, int *sysid, l_name node, l_name
Sclass)
Return the system identifier sysid, the logical name node and the system class
Sclass of the next object in set set_id.
int return_prm(int sessionID, int set_id, cm_value *cmv)
An answer set may contain primitive values (integers, strings etc) and the
previous functions would fail to read these items. This function returns the
next object in set set_id whatever it is. (See section 6.8.1 for definition of
cm_value structure).
int return_categ_ids(int sessionID, int set_id, int *sysid, l_name cls, l_name categ)
Return the logical name categ and the system identifier sysid, the logical name
cls of the from-class of the next object in set set_id. Set set_id is supposed to
contain link objects.
int return_categories(int sessionID, int set_id, l_name cls, l_name categ)
August 2002/v2.2.2 -33- ICS-FORTH