OpenDBX/C API/odbx query

#include <odbx.h>

int odbx_query(
    odbx_t* handle,
    const char* query,
    unsigned long length )

Description:

Sends a query string to the database server which must be terminated by a \0 character. Some backends support multiple statements per query, which can be tested by calling odbx_get_option().

After invoking odbx_query(), the results sent back by the server are available via the odbx_result() function.

Parameters:

• handle: Connection object created by odbx_init()
• query: String terminated by \0 consisting of one or more statements
• length: Length of the query string without the terminating \0 character

Return values

odbx_get_option() returns ODBX_ERR_SUCCESS, or an error code whose value is less than zero if one of the operations couldn't be completed successfully. Possible error codes are listed in the error section and they can be feed to odbx_error() and odbx_error_type() to get further details.

Errors

• -ODBX_ERR_BACKEND: The native database library returned an error because it wasn't able to handle the query statement correctly

-ODBX_ERR_PARAM 

Either handle or the query string are NULL or handle is invalid

• -ODBX_ERR_NOMEM: Allocating the required memory for the query string failed

See also:

• OpenDBX_error
• OpenDBX_error_type
• OpenDBX_result

---

Back to Overview