描述
返回分配给SELECT语句结果集中特定列的名称。
C / C ++语法
const char *sqlite3_column_name16(sqlite3_stmt*, int N); |
PB语法
FUNCTION sqlite3_column_name16 ( _ BYVAL hStmt AS DWORD, _ BYVAL colNumber AS LONG _ ) AS DWORD |
参数
pStmt
[in]准备好的语句句柄。
colNumber
[in]结果集的列号。结果集的最左列有索引0。结果中的列数可以使用sqlite3_column_count确定。
返回值
指向分配给指定列的名称的指针。结果列的名称是该列的“AS”子句的值，如果存在AS子句。如果没有AS子句，则列的名称是未指定的，并且可能会从SQLite的一个版本更改为下一个。返回的字符串指针是有效的，直到准备好的语句被sqlite3_finalize销毁，或者直到语句被首次调用sqlite3_step为特定运行或直到下一次调用sqlite3_column_name或sqlite3_column_name16为止同一列。如果sqlite3_malloc（）在处理任一功能（例如在从UTF-8到UTF-16的转换期间）失败，则返回NULL指针。
C ++实现代码
/*
** Return the name of the Nth column of the result set returned by SQL
** statement pStmt.
*/
SQLITE_API const char *sqlite3_column_name(sqlite3_stmt *pStmt, int N){
return columnName(
pStmt, N, (const void*(*)(Mem*))sqlite3_value_text, COLNAME_NAME);
}
#ifndef SQLITE_OMIT_UTF16
SQLITE_API const void *sqlite3_column_name16(sqlite3_stmt *pStmt, int N){
return columnName(
pStmt, N, (const void*(*)(Mem*))sqlite3_value_text16, COLNAME_NAME);
}
#endif