NAME

       odbx_column_name - Get the name of a column in the current result set

SYNOPSIS

       #include <opendbx/api.h>

       char* odbx_column_name (odbx_result_t* result, unsigned long pos);

DESCRIPTION

       odbx_column_name()  gets  the  name  of the column specified by pos in the current result set returned by
       odbx_result(). The column names will not change within the result set with the  exception  described  for
       MySQL  in  odbx_column_count() when the first result set wasn't retrieved completely before odbx_result()
       was called again.

       The result parameter required by this function must be a valid result set returned by  odbx_result()  and
       must not have been feed to odbx_result_finish() before.

       Valid column indices for the requested column provided via pos start with zero and end with the value re‐
       turned by odbx_column_count() minus one.

RETURN VALUE

       The  return  value  of  odbx_column_name() is a pointer to a zero terminated string which consists of the
       name of the requested column. This pointer is allocated by the database client library and  must  not  be
       freed  by  the  application.  The  content of the string may be overwritten by the next call to odbx_col‐
       umn_name()

ERRORS

       Errors can occur if the given result parameter is NULL or invalid or if the value of pos is out of range,
       i.e. more than odbx_column_count() minus one.

SEE ALSO

       odbx_column_count(), odbx_column_type(), odbx_result()

                                                  3 April 2024                               odbx_column_name(3)