qorus-client.ql File Reference

this is the main include file for the Qorus client library More...

Functions
deprecated hash	omq_read_option_file ()
	backwards-compatible option parsing - parses everything into a single hash
deprecated	parse_dbparams ()
	backwards-compatible function
deprecated	process_datasource (string line)
	backwards-compatible function
deprecated Datasource	get_datasource (string name)
	backwards-compatible function
	open_datasources ()
	opens all system datasource and any optional list of datasources given to the function
string	getWarningString (hash ex)
	returns a string representing a warning from an exception hash
string	get_next_sequence_value (string name)
	returns the next value of the given sequence from the system "omq" datasource as a string
int	get_next_sequence_value_int (string name)
	returns the next value of the given sequence from the system "omq" datasource as an int
list	insert_in_list (list l, any val, int pos)
	inserts an element in a list
list	insert_in_list (reference l, any val, int pos)
	inserts an element in a list
hash	remove_key (hash h, string key)
	removes a key from a hash
int	get_index (list l, any val)
	returns the index of the first element in the list that matches the 2nd argument with soft comparisons
deprecated *string	get_program_name ()
	returns the current script name
bool	unique_elements (list l, any dup)
	returns True if the list has all unique elements; uses soft comparisons
bool	unique_elements_hard (list l, any dup)
	returns True if the list has all unique elements; uses hard comparisons

Detailed Description

this is the main include file for the Qorus client library

Function Documentation

get_datasource()

deprecated Datasource get_datasource

(

string

name

)

backwards-compatible function

Deprecated:

use omqclient.getDatasource() or get_datasource_dedicated() instead

get_next_sequence_value()

string get_next_sequence_value

(

string

name

)

returns the next value of the given sequence from the system "omq" datasource as a string

Parameters

name	the name of the sequence to use

Returns

the next value of the given sequence from the system "omq" datasource as a string

get_next_sequence_value_int()

int get_next_sequence_value_int

(

string

name

)

returns the next value of the given sequence from the system "omq" datasource as an int

Parameters

name	the name of the sequence to use

Returns

the next value of the given sequence from the system "omq" datasource as a string

get_program_name()

deprecated *string get_program_name

(

)

returns the current script name

Deprecated:

use standard Qore function get_script_name() instead

getWarningString()

string getWarningString

(

hash

ex

)

returns a string representing a warning from an exception hash

Parameters

ex	an exception hash

Returns

a string representing a warning

insert_in_list() [1/2]

list insert_in_list	(	list	l,
		any	val,
		int	pos
	)

inserts an element in a list

Deprecated:

use qore's splice operator instead; it's faster and standard Qore functionality

insert_in_list() [2/2]

list insert_in_list	(	reference	l,
		any	val,
		int	pos
	)

inserts an element in a list

Deprecated:

use qore's splice operator instead; it's faster and standard Qore functionality

omq_read_option_file()

deprecated hash omq_read_option_file

(

)

backwards-compatible option parsing - parses everything into a single hash

Deprecated:

use qorus_parse_options() instead

parse_dbparams()

deprecated parse_dbparams

(

)

backwards-compatible function

Deprecated:

it is not necessary to call this function directly anymore; just call qorus_client_init() or qorus_client_init2() and then ::omqclient.getDatasource(), etc

process_datasource()

deprecated process_datasource

(

string

line

)

backwards-compatible function

Deprecated:

use omqclient.setDatasourceFromText() instead

remove_key()

hash remove_key	(	hash	h,
		string	key
	)

removes a key from a hash

Deprecated:

use the "-" operator instead (hash - string); it is faster and standard Qore functionality