logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

odbx_capabilities - Query implemented capabilities

Description

odbx_capabilities() ask the backend associated to the connection object returned by odbx_init() if a cer‐
       tain  capability  set is implemented by this backend. All backends have to implement the basic capability
       set and may implement further predefined functional sets if they are supported  by  the  native  database
       client library. This function can be called at any stage after odbx_init() returned successfully.

       The  first  parameter  handle has to be the connection object created and returned by odbx_init(). It be‐
       comes invalid as soon as it was supplied to odbx_finish() and odbx_capabilities() will return an error in
       this case.

       cap is the number of the capability set as defined by macro constants in  odbx.h.  Valid  constant  names
       which can be supplied as second parameter to odbx_capabilities() are listed below:

       -ODBX_CAP_BASIC
              The  core  function set which have to be implemented by all backends. It consists of all functions
              necessary to connect to, send textual queries to and process  simple  results  returned  from  the
              database server as well as error handling functions.

Errors

       -ODBX_ERR_PARAM
              handle is NULL or the supplied connection object is invalid

Name

       odbx_capabilities - Query implemented capabilities

Return Value

odbx_capabilities() returns ODBX_ENABLE if the requested capability is supported, ODBX_DISABLE if the ca‐
       pability  is  not supported or an error code whose value is less than zero if one of the supplied parame‐
       ters is invalid. Possible error codes are listed in the error section and they can be  feed  to  odbx_er‐ror() and odbx_error_type() to get further details.

See Also

odbx_error(), odbx_error_type(), odbx_init()

                                                 8 January 2025                             odbx_capabilities(3)

Synopsis

       #include <opendbx/api.h>

       int odbx_capabilities (odbx_t* handle, unsigned int cap);

See Also