qdb_column_name()

Synopsis:

#include <qdb/qdb.h>

const char * qdb_column_name( qdb_result_t *res,
                              int col );

Arguments:

res: A pointer to a result structure to check.
col: The index of the column name to return, where the leftmost column is 0.

Library:

qdb

Description:

This function returns the name of a specified column index col, as defined in a database schema when the table was created.

Returns:

A pointer to the specified column's name, or NULL if an error occurred (errno is set). The string containing the column name is part of the results set, so the string memory is freed (along with the rest of the results set memory) by qdb_freeresult(). If you want to keep the column name longer, you should create a copy of the string (and manage that copy's memory).

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes