Grass Valley K2 TX/MAM Database Protocol Manual v.2.2 - Manual (Page 8)

TX/MAM Database Protocol Manual - document version: 2.2 – Page 8
6.
Database search functions
Use the functions described in this section to search the database.
A search command consists of a number (>=1) of criteria that constitute the query that will be used to
match the records. Criteria can be used with the 'and' and 'or' logical operators. The result of a search
command is a list of IDs of records that matched the criteria.
Most criteria can only use fields that reside in the same table. SQL-criteria are an exception to this
rule.
Restrict the number of records in the result list as much as possible, especially when retrieving a
main_event from a Playlist. Too many records will result in a failure on the call. Returning a great
number of records can have a negative effect on system performance.
6.1 Clearing all criteria used in a previous search
int cob_criteria_clear( void );
Parameters
No parameters required
Result
The result of the function is an integer with the following values:
Value Description
0 Success, all criteria cleared.
-1 Failure.
Example
cob_criteria_clear(); /* continue with the rest of the applet */