posts - 126,  comments - 73,  trackbacks - 0

int sqlite3_open(
  const char *filename,   /* Database filename (UTF-8) */
  sqlite3 **ppDb          /* OUT: SQLite db handle */
);
功能:打开数据库,如果不存在则自动创建.
PARAM1(IN): 数据库文件名,UTF-8格式
PARAM2(OUT):  返回的数据库句柄
返回值:返回SQLITE_OK成功,反之失败(数据库句柄ppDb为空),失败值见具体SQLITE_*定义.
=====================================================================================

int sqlite3_close(sqlite3 *);
功能:关闭数据库
PARAM1(IN):打开的数据库句柄
返回值:返回SQLITE_OK成功,反之失败.
=====================================================================================

int sqlite3_exec(
  sqlite3*,                     /* An open database */
  const char *sql,              /* SQL to be executed */
  sqlite3_callback,             /* Callback function */
  void *,                       /* 1st argument to callback function */
  char **errmsg                 /* Error msg written here */
);
功能:执行SQL
PARAM1(IN):数据库句柄
PARAM2(IN):sql语句,以\0结尾.
PARAM3(IN):回调函数
PARAM4(IN):回调参数
PARAM5(OUT):输出错误信息
返回值:SQLITE_OK成功,反之失败,失败后错误信息见PARAM5;
说明:如果有多条SQL语句,中间用分号(;)隔开.回调函数和回调参数通常在查询语句会用到,
对每条查询结果结果都会调用回调函数一次.
回调函数格式:
typedef int(*sqlite3_callback)(void *,int ,char **,char **);
参数1:sqlite3_exec中传入的参数
参数2:总列数.
参数3:列数据(char*)
参数4:列名称(char*)

=====================================================================================
int sqlite3_get_table(
  sqlite3*,               /* An open database */
  const char *sql,       /* SQL to be executed */
  char ***resultp,       /* Result written to a char *[]  that this points to */
  int *nrow,             /* Number of result rows written here */
  int *ncolumn,          /* Number of result columns written here */
  char **errmsg          /* Error msg written here */
);
功能:查询表
PARAM1(IN):数据库句柄
PARAM2(IN):sql语句,以\0结尾.
PARAM3(OUT):查询结果
PARAM4(OUT):返回行数(多少条数据)
PARAM5(OUT):返回列数(多少字段)
PARAM6(OUT):返回错误信息
返回值:SQLITE_OK成功,房子失败见错误信息

=====================================================================================
void sqlite3_free_table(char **result);
功能:释放通过sqlite3_get_table查询保存的结果数据
PARAM1(IN):要释放的数据指针


=====================================================================================
int sqlite3_prepare(
  sqlite3 *db,            /* Database handle */
  const char *zSql,       /* SQL statement, UTF-8 encoded */
  int nBytes,             /* Length of zSql in bytes. */
  sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
  const char **pzTail     /* OUT: Pointer to unused portion of zSql */
);
功能:构造查询
PARAM1(IN):数据库句柄
PARAM2(IN):sql语句
PARAM3(IN):sql语句长度,设置成-1则自动按字符串计算sql语句长度
PARAM4(OUT):保存的查询结构体,
PARAM5(OUT):NULL即可
返回值:SQLITE_OK成功.


=====================================================================================
int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));
功能:为查询结构体绑定数据
PARAM1(IN):查询结构体
PARAM2(IN):绑定第几个数据(sql语句中的第几个问号(?))
PARAM3(IN):二进制数据指针
PARAM4(IN):二进制数据长度
PARAM5(IN):析构回调函数,通常设置NULL,结束后自己释放
返回值:S_OK成功.
说明:绑定函数必须要在sqlite3_step前,sqlite3_prepare或者sqlite3_reset之后调用.
未绑定的参数缺省为NULL,类似的绑定函数还有以下
int sqlite3_bind_double(sqlite3_stmt*, int, double);
int sqlite3_bind_int(sqlite3_stmt*, int, int);
int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite_int64);
int sqlite3_bind_null(sqlite3_stmt*, int);
int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));
int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int, void(*)(void*));
int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);

 

=====================================================================================
int sqlite3_reset(sqlite3_stmt *pStmt);
功能:重置所有绑定的值,回到刚刚调用sqlite3_prepare后的状态


=====================================================================================
int sqlite3_step(sqlite3_stmt*);
功能:执行查询
PARAM1:查询结构体
返回值:
SQLITE_BUSY:数据库被锁,可以等待释放后重新调用该函数
SQLITE_DONE:成功
SQLITE_ROW:成功并且有数据返回,对每查询到一条数据都会返回该值,
   可以调用sqlite3_column_*函数获取数据后重新调用处理下一条数据
SQLITE_ERROR:失败
SQLITE_MISUSE:错误的调用,比如已经返回了SQLITE_DONE或者SQLITE_ERROR后还继续调用该函数


=====================================================================================
int sqlite3_finalize(sqlite3_stmt *pStmt);
功能:释放查询结构体

=====================================================================================
int sqlite3_key(
  sqlite3 *db,                   /* Database to be rekeyed */
  const void *pKey, int nKey     /* The key */
);
功能:为加密的数据库指定密码,改函数在sqlite3_open之后调用

=====================================================================================
int sqlite3_rekey(
  sqlite3 *db,                   /* Database to be rekeyed */
  const void *pKey, int nKey     /* The new key */
);
功能:重设数据库密码,如果pKey = 0 或者 nKey = 0,这数据库不加密


=====================================================================================

 


const char *sqlite3_libversion(void);
int sqlite3_libversion_number(void);
功能:获取版本号

sqlite_int64 sqlite3_last_insert_rowid(sqlite3*);
功能:获取最后插入的行标示.

int sqlite3_changes(sqlite3*);
功能:获取最近执行的sqlite3_exec影响的行数.

int sqlite3_total_changes(sqlite3*);
功能:获取自从数据库打开后有改动的函数

void sqlite3_interrupt(sqlite3*);
功能:打断或停止数据库当前操作.

int sqlite3_complete(const char *sql);
功能:判断语句是否以分号(;)结尾

int sqlite3_busy_handler(sqlite3*, int(*)(void*,int), void*);
功能:设置查询忙碌时的回调处理
说明:缺省的回调函数为空,如果回调函数为空,表锁定后sqlite3_exec()执行会直接返回SQLITE_BUSY

int sqlite3_busy_timeout(sqlite3*, int ms);
功能:设置查询超时时间(毫秒)

 

char *sqlite3_mprintf(const char*,...);
char *sqlite3_vmprintf(const char*, va_list);
char *sqlite3_snprintf(int,char*,const char*, ...);
功能:格式化字符,需要用%q来代替%s.(主要是不用对分号'进行转义)


void *sqlite3_malloc(int);
void *sqlite3_realloc(void*, int);
void sqlite3_free(void*);
功能:内存函数

int sqlite3_set_authorizer(
  sqlite3*,
  int (*xAuth)(void*,int,const char*,const char*,const char*,const char*),
  void *pUserData
);
功能:设置数据库授权

void *sqlite3_trace(sqlite3*, void(*xTrace)(void*,const char*), void*);
void *sqlite3_profile(sqlite3*,
   void(*xProfile)(void*,const char*,sqlite_uint64), void*);

void sqlite3_progress_handler(sqlite3*, int, int(*)(void*), void*);
功能:设置执行回调函数,sqlite3_exec(),sqlite3_step() ,sqlite3_get_table()时会调用

void *sqlite3_commit_hook(sqlite3*, int(*)(void*), void*);
功能:设置事务回调函数

int sqlite3_errcode(sqlite3 *db);
const char *sqlite3_errmsg(sqlite3*);
功能:获取错误码和错误消息

int sqlite3_bind_parameter_count(sqlite3_stmt*);
功能:返回需要绑定的参数数目(sql语句中问号?数量)

const char *sqlite3_bind_parameter_name(sqlite3_stmt*, int);
功能:获取绑定参数名字,?参数返回NULL

int sqlite3_bind_parameter_index(sqlite3_stmt*, const char *zName);
功能:获取绑定参数索引

int sqlite3_clear_bindings(sqlite3_stmt*);
功能:清除绑定的参数


int sqlite3_column_count(sqlite3_stmt *pStmt);
功能:获取列数
const char *sqlite3_column_name(sqlite3_stmt*,int);
功能:获取列名


const char *sqlite3_column_database_name(sqlite3_stmt*,int);
const void *sqlite3_column_database_name16(sqlite3_stmt*,int);
const char *sqlite3_column_table_name(sqlite3_stmt*,int);
const void *sqlite3_column_table_name16(sqlite3_stmt*,int);
const char *sqlite3_column_origin_name(sqlite3_stmt*,int);
const void *sqlite3_column_origin_name16(sqlite3_stmt*,int);
功能:返回列信息?

const char *sqlite3_column_decltype(sqlite3_stmt *, int i);
功能:返回列数据类型

int sqlite3_data_count(sqlite3_stmt *pStmt);
功能:返回数据数量(行数)

 

const void *sqlite3_column_blob(sqlite3_stmt*, int iCol);
int sqlite3_column_bytes(sqlite3_stmt*, int iCol);
int sqlite3_column_bytes16(sqlite3_stmt*, int iCol);
double sqlite3_column_double(sqlite3_stmt*, int iCol);
int sqlite3_column_int(sqlite3_stmt*, int iCol);
sqlite_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol);
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
const void *sqlite3_column_text16(sqlite3_stmt*, int iCol);
int sqlite3_column_type(sqlite3_stmt*, int iCol);
int sqlite3_column_numeric_type(sqlite3_stmt*, int iCol);
sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);
功能:获取列数据


int sqlite3_create_function(
  sqlite3 *,
  const char *zFunctionName,
  int nArg,
  int eTextRep,
  void*,
  void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
  void (*xStep)(sqlite3_context*,int,sqlite3_value**),
  void (*xFinal)(sqlite3_context*)
);
功能:

const void *sqlite3_value_blob(sqlite3_value*);
int sqlite3_value_bytes(sqlite3_value*);
int sqlite3_value_bytes16(sqlite3_value*);
double sqlite3_value_double(sqlite3_value*);
int sqlite3_value_int(sqlite3_value*);
sqlite_int64 sqlite3_value_int64(sqlite3_value*);
const unsigned char *sqlite3_value_text(sqlite3_value*);
const void *sqlite3_value_text16(sqlite3_value*);
const void *sqlite3_value_text16le(sqlite3_value*);
const void *sqlite3_value_text16be(sqlite3_value*);
int sqlite3_value_type(sqlite3_value*);
int sqlite3_value_numeric_type(sqlite3_value*);
功能:类似sqlite3_column_*函数

 

 

 

 

posted on 2011-06-10 16:08 我风 阅读(2848) 评论(0)  编辑 收藏 引用

只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


<2011年6月>
2930311234
567891011
12131415161718
19202122232425
262728293012
3456789

常用链接

留言簿(12)

随笔分类

随笔档案

文章档案

相册

收藏夹

C++

MyFavorite

搜索

  •  

积分与排名

  • 积分 - 319868
  • 排名 - 74

最新评论

阅读排行榜

评论排行榜