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 的不同版本之間有所改變。