Имена столбцов в наборе результатов

const char *sqlite3_column_name(sqlite3_stmt*, int N);
const void *sqlite3_column_name16(sqlite3_stmt*, int N);

Эти функции возвращают имя, назначенное конкретному столбцу в наборе результатов оператора SELECT. Интерфейс sqlite3_column_name() возвращает указатель на строку с нуль-терминатором UTF-8, а sqlite3_column_name16() возвращает указатель на строку с нуль-терминатором UTF-16. Первый параметр — это подготовленный оператор, который реализует оператор SELECT. Второй параметр — номер столбца. Самый левый столбец имеет номер 0.

Возвращаемый указатель на строку действителен до тех пор, пока подготовленный оператор не будет уничтожен функцией sqlite3_finalize(), или пока оператор не будет автоматически переподготовлен первым вызовом sqlite3_step() для конкретного выполнения, или пока не будет сделан следующий вызов sqlite3_column_name() или sqlite3_column_name16() для того же столбца.

Если sqlite3_malloc() завершается неудачей во время обработки любой из функций (например, при преобразовании из UTF-8 в UTF-16), то возвращается значение NULL.

Имя столбца результата — это значение оператора "AS" для этого столбца, если такой оператор есть. Если оператора AS нет, то имя столбца не определено и может меняться от одной версии SQLite к другой.

См. также списки Объектов, Констант и Функций.