sqlite3_column_name(3) - NetBSD Manual Pages

SQLITE3_COLUMN_NAME(3)  NetBSD Library Functions Manual SQLITE3_COLUMN_NAME(3)


NAME

     sqlite3_column_name, sqlite3_column_name16 -- column names in a result
     set


SYNOPSIS

     #include <sqlite3.h>

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

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


DESCRIPTION

     These routines return the name assigned to a particular column in the
     result set of a SELECT statement.  The sqlite3_column_name() interface
     returns a pointer to a zero-terminated UTF-8 string and sqlite3_col-
     umn_name16() returns a pointer to a zero-terminated UTF-16 string.  The
     first parameter is the prepared statement that implements the SELECT
     statement.  The second parameter is the column number.  The leftmost col-
     umn is number 0.

     The returned string pointer is valid until either the prepared statement
     is destroyed by sqlite3_finalize() or until the statement is automati-
     cally reprepared by the first call to sqlite3_step() for a particular run
     or until the next call to sqlite3_column_name() or sqlite3_col-
     umn_name16() on the same column.

     If sqlite3_malloc() fails during the processing of either routine (for
     example during a conversion from UTF-8 to UTF-16) then a NULL pointer is
     returned.

     The name of a result column is the value of the "AS" clause for that col-
     umn, if there is an AS clause.  If there is no AS clause then the name of
     the column is unspecified and may change from one release of SQLite to
     the next.


IMPLEMENTATION NOTES

     These declarations were extracted from the interface documentation at
     line 5117.

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


SEE ALSO

     sqlite3_finalize(3), sqlite3_step(3), sqlite3_stmt(3)

NetBSD 11.99                    April 29, 2026                    NetBSD 11.99