summaryrefslogtreecommitdiff
path: root/static/netbsd/man3/sqlite3_column_name.3
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
commit253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch)
treeadf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man3/sqlite3_column_name.3
parenta9157ce950dfe2fc30795d43b9d79b9d1bffc48b (diff)
docs: Added All NetBSD Manuals
Diffstat (limited to 'static/netbsd/man3/sqlite3_column_name.3')
-rw-r--r--static/netbsd/man3/sqlite3_column_name.358
1 files changed, 58 insertions, 0 deletions
diff --git a/static/netbsd/man3/sqlite3_column_name.3 b/static/netbsd/man3/sqlite3_column_name.3
new file mode 100644
index 00000000..be28cd87
--- /dev/null
+++ b/static/netbsd/man3/sqlite3_column_name.3
@@ -0,0 +1,58 @@
+.Dd January 24, 2024
+.Dt SQLITE3_COLUMN_NAME 3
+.Os
+.Sh NAME
+.Nm sqlite3_column_name ,
+.Nm sqlite3_column_name16
+.Nd column names in a result set
+.Sh SYNOPSIS
+.In sqlite3.h
+.Ft const char *
+.Fo sqlite3_column_name
+.Fa "sqlite3_stmt*"
+.Fa "int N"
+.Fc
+.Ft const void *
+.Fo sqlite3_column_name16
+.Fa "sqlite3_stmt*"
+.Fa "int N"
+.Fc
+.Sh 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_column_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 column is number 0.
+.Pp
+The returned string pointer is valid until either the prepared statement
+is destroyed by
+.Fn sqlite3_finalize
+or until the statement is automatically reprepared by the first call
+to
+.Fn sqlite3_step
+for a particular run or until the next call to sqlite3_column_name()
+or sqlite3_column_name16() on the same column.
+.Pp
+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.
+.Pp
+The name of a result column is the value of the "AS" clause for that
+column, 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.
+.Sh IMPLEMENTATION NOTES
+These declarations were extracted from the
+interface documentation at line 4792.
+.Bd -literal
+SQLITE_API const char *sqlite3_column_name(sqlite3_stmt*, int N);
+SQLITE_API const void *sqlite3_column_name16(sqlite3_stmt*, int N);
+.Ed
+.Sh SEE ALSO
+.Xr sqlite3_finalize 3 ,
+.Xr sqlite3_step 3 ,
+.Xr sqlite3_stmt 3