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

SIS-Application Programmatic Interface, Reference Manual
int tuple_set_join_pos(int sessionID, int set_id, int x, int y)
Marks the column x as the column of the tuple set_id to be joined to the
column y of the candidate tuple to joined with by tuple_join() function.
int tuple_reset_join_pos(int sessionID, int set_id)
Resets the marked column positions of the tuple set_id that where set by
tuple_set_join_pos() function.
int tuple_join(int sessionID, int set_id1, int set_id2)
Forms the join of the tuple set_id1 that also holds the marked tuple’s column
position information (set by tuple_set_join_pos()) with the tuple set_id2.
int tuple_union(int sessionID, int set_id1, int set_id2)
Forms the union of the tuple set_id1 with the tuple set_id2.
int tuple_difference(int sessionID, int set_id1, int set_id2)
Forms the difference of the tuple set_id1 with the tuple set_id2.
int tuple_no_projection_column(int sessionID, int set_id, int x)
Hides the column x from tuple set_id connecting accordingly the
"surrounding" tuples.
int return_tuple(int sessionID, int set_id, cm_value *cmv)
Each time this function is called it returns the next item in the given tuple in
cmv. If the current tuple position is empty cmv will be undefined and will have
the tag TYPE_EMPTY. It returns END_OF_TUPLE if the end of the tuple was
reached or END_OF_FIELD if the end of the current field was reached.
int return_relation(int sessionID, int from_set ,int categ_set, int to_set)
This function is not implemented yet.
int unary_on_tuple(int sessionID, int set_id)
This function is not implemented yet.
6.7 Update Functions
The API provides a set of functions used to make updates in the Database. The
operations that can be performed are:
• Addition operations
• Deletion operations
• Modification operations
A difference between the update functions and the rest of the API is that they do not
require a current node to work on. Also the concept of the IDENTIFIER is used. An
IDENTIFIER is a structure that can hold either a logical name (char *) or a system
identifier (int). The type of the IDENTIFIER is given by a tag. Most functions work
August 2002/v2.2.2 -37- ICS-FORTH