20.01.2014 Views

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

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

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

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>SIS</strong>- <strong>Application</strong> <strong>Programmatic</strong> <strong>Interface</strong>, <strong>Reference</strong> <strong>Manual</strong><br />

the category given. The meta-category is defined by the name of the link and<br />

the class of which it is pointing from. The answer set contains the system<br />

identifiers of these objects.<br />

If set_id is a positive integer, apply get_to_node_by_meta_category() on<br />

each object in temporary set set_id.<br />

int get_from_node_by_meta_category(int sessionID, int set_id, l_name fromcls,<br />

l_name categ)<br />

If set_id is 0, get all objects that are connected to the current node by links<br />

pointing from them. Links must be instances of some link class that is instance<br />

of the category given. The meta-category is defined by the name of the link<br />

and the class of which it is pointing from. The answer set contains the system<br />

identifiers of these objects.<br />

If set_id is a positive integer, apply get_from_node_by_meta_category() on<br />

each object in temporary set set_id.<br />

int get_from_value(int sessionID, int set_id)<br />

Get the objects that the link objects in temporary set set_id are pointing from.<br />

The answer set contains the system identifiers of these objects.<br />

If set_id is 0, apply get_from_value() on current node.<br />

int get_to_value(int sessionID, int set_id)<br />

Get the objects that the link objects in temporary set set_id are pointing to.<br />

The answer set contains the system identifiers of these objects, or/and<br />

primitive values.<br />

If set_id is 0, apply get_to_value() on current node.<br />

6.3.3 Logical expressions - Object set filtering<br />

There are cases that you want to select some objects according to some condition. For<br />

this reason API offers the following function:<br />

int get_filtered(int sessionID, int set_id)<br />

From all objects in the set set_id select only those object that satisfy a<br />

condition that has been previously defined with the set_filter_cond() function,<br />

described later. The answer set contains all these selected objects.<br />

If set_id is 0, evaluate the condition for the current node and if it is true put<br />

current node in answer set else return an empty set. The function returns<br />

APIFail(-1) on error or the set identifier of the temporary set where the answer<br />

is stored.<br />

The condition used by get_filtered() function can be defined with the following<br />

function:<br />

int set_filter_cond(log_exp)<br />

Define a logical expression that can be true of false for a specific object.<br />

August 2002/v2.2.2 -18- <strong>ICS</strong>-FORTH

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!