1 、打開數(shù)據(jù)庫(kù):
說明:打開一個(gè)數(shù)據(jù)庫(kù),文件名不一定要存在,如果此文件不存在, sqlite 會(huì)自動(dòng)創(chuàng)建。第一個(gè)參數(shù)指文件名,第二個(gè)參數(shù)則是定義的 sqlite3 ** 結(jié)構(gòu)體指針(關(guān)鍵數(shù)據(jù)結(jié)構(gòu)),這個(gè)結(jié)構(gòu)底層細(xì)節(jié)如何,您不用管它。
int sqlite3_open(
const char *filename, /* Database filename (UTF-8) */
sqlite3 **ppDb /* OUT: SQLite db handle */
);
返回值:表示操所是否正確 ( SQLITE_OK 操作正常)
2 、關(guān)閉數(shù)據(jù)庫(kù):
說明:如果用 sqlite3_open 開啟了一個(gè)數(shù)據(jù)庫(kù),結(jié)尾時(shí)不要忘了用這個(gè)函數(shù)關(guān)閉數(shù)據(jù)庫(kù)。
int sqlite3_close(sqlite3*); // 參數(shù)就是剛才的結(jié)構(gòu)體,也就是數(shù)據(jù)庫(kù)句柄
3 、執(zhí)行 SQL 語句:
說 明:這個(gè)函數(shù)的功能是執(zhí)行一條或者多條 SQL 語句, SQL 語句之間用 “;” 號(hào)隔開。建議在執(zhí)行一條或者多條 SQL 語句得時(shí)候,指定第三個(gè)參數(shù)回調(diào)函數(shù),在 回調(diào)函數(shù)中可以獲得執(zhí)行 Sql 得詳細(xì)過程,如果所有 Sql 執(zhí)行完畢則應(yīng)該返回 0 ,否則,則說明這次執(zhí)行并沒有完全成功。第五個(gè)參數(shù):如果執(zhí)行失?。]有返回 0 )則可以查看第五個(gè)闡述得值。來查看詳細(xì)錯(cuò)誤信息。
int sqlite3_exec(
sqlite3*, /* 已經(jīng)打開的數(shù)據(jù)庫(kù)句柄 */
const char *sql, /* 要執(zhí)行的 Sql 語句 */
sqlite_callback, /* 回調(diào)函數(shù) */
void *, /* 傳遞給回調(diào)函數(shù)的參數(shù) */
char **errmsg /* 保存錯(cuò)誤信息 */
);
通常 sqlite3_callback 和它后面的 void* 這兩個(gè)位置都可以填 NULL ,表示不需要回調(diào)。比如您做 insert 操作,做 delete 操作,就沒有必要使用回調(diào)。而當(dāng)作 select 時(shí),就要使用回調(diào),因?yàn)?sqlite3 把數(shù)據(jù)查出來,得通過回調(diào)告訴你查出了什么數(shù)據(jù)。
4 、 exec 的回調(diào)
typedef int (*sqlite3_callback)(void*, int, char**, char**);
說明:你的回調(diào)函數(shù)必須定義為上面這個(gè)函數(shù)的類型。
例如:
int LoadMyInfo( void * para, int n_column, char ** column_value, char ** column_name )
{
//para 是你在 sqlite3_exec 里傳入的 void * 參數(shù)
// 通過 para 參數(shù),你可以傳入一些特殊的指針(比如類指針、結(jié)構(gòu)指針),然后在這里面強(qiáng)制轉(zhuǎn)換成對(duì)應(yīng)的類型(這里面是 void* 類型,必須強(qiáng)制轉(zhuǎn)換成你的類型才可用)。然后操作這些數(shù)據(jù)
//n_column 是這一條記錄有多少個(gè)字段 ( 即這條記錄有多少列 )
// char ** column_value 是個(gè)關(guān)鍵值,查出來的數(shù)據(jù)都保存在這里,它實(shí)際上是個(gè) 1 維數(shù)組(不要以為是 2 維數(shù)組),每一個(gè)元素都是一個(gè) char * 值,是一個(gè)字段內(nèi)容(用字符串來表示,以 \0 結(jié)尾)
//char ** column_name 跟 column_value 是對(duì)應(yīng)的,表示這個(gè)字段的字段名稱
5 、取當(dāng)前插入位置:
功能:返回你前一次插入得位置,從 1 開始, sqlite3* 為你打開數(shù)據(jù)庫(kù)所得到得句柄。
long long int sqlite3_last_insert_rowid(sqlite3*);
6 、非回調(diào) select 查詢:
功能:執(zhí)行一次查詢 Sql 并且返回得到一個(gè)記錄集。
int sqlite3_get_table(
sqlite3*, /* 已經(jīng)打開的數(shù)據(jù)庫(kù)句柄 */
const char *sql, /* 要執(zhí)行的 Sql 語句 */
char ***resultp, /* 保存返回記錄集的指針 */
int *nrow, /* 返回記錄數(shù)(及查出多少行) */
int *ncolumn, /* 返回字段數(shù)(多少列) */
char **errmsg /* 返回錯(cuò)誤信息 */
)
說明:第三個(gè)參數(shù)是查詢結(jié)果,它是一維數(shù)組,內(nèi)存布局為:第一行是字段名稱,后面是緊接著是每個(gè)字段的值。
實(shí)例:
int main( int , char ** )
{
sqlite3 * db;
int result;
char * errmsg = NULL;
char **dbResult;
int nRow, nColumn;
int i , j;
int index;
result = sqlite3_open( “c:\\Dcg_database.db”, db );
if( result != SQLITE_OK )
{
return -1;
}
// 數(shù)據(jù)庫(kù)操作代碼
// 假設(shè)前面已經(jīng)創(chuàng)建了 MyTable_1 表
// 開始查詢,傳入的 dbResult 已經(jīng)是 char ** ,這里又加了一個(gè) 取地址符,傳遞進(jìn)去的就成了 char ***
result = sqlite3_get_table( db, “select * from MyTable_1”, dbResult, nRow, nColumn, errmsg );
if( SQLITE_OK == result )
{
// 查詢成功
index = nColumn; // 前面說過 dbResult 前面第一行數(shù)據(jù)是字段名稱,從 nColumn 索引開始才是真正的數(shù)據(jù)
printf( “ 查到 %d 條記錄 \n”, nRow );
for( i = 0; i nRow ; i++ )
{
printf( “ 第 %d 條記錄 \n”, i+1 );
for( j = 0 ; j nColumn; j++ )
{
printf( “ 字段名 :%s ?> 字段值 :%s\n”, dbResult[j], dbResult [index] );
++index; // dbResult 的字段值是連續(xù)的,從第 0 索引到第 nColumn - 1 索引都是字段名稱,從第 nColumn 索引開始,后面都是字段值,它把一個(gè)二維的表(傳統(tǒng)的行列表示法)用一個(gè)扁平的形式來表示
}
printf( “-------\n” );
}
}
// 到這里,不論數(shù)據(jù)庫(kù)查詢是否成功,都釋放 char** 查詢結(jié)果,使用 sqlite 提供的功能來釋放
sqlite3_free_table( dbResult );
// 關(guān)閉數(shù)據(jù)庫(kù)
sqlite3_close( db );
return 0;
}
7 、釋放查詢結(jié)果:
功能:釋放當(dāng)前查詢的記錄集所占用的內(nèi)存
void sqlite3_free_table(char **result);
實(shí)例:( SQLite 數(shù)據(jù)庫(kù)使用回調(diào)函數(shù)的簡(jiǎn)單 C 語言實(shí)例)
復(fù)制代碼 代碼如下:
#include stdio.h>
#include sqlite3.h>
static int callback( void *NotUsed, int argc, char **argv, char **azColName)
{
int i;
for (i=0; iargc; i++)
{
printf( "%s = %s\n" , azColName[i], argv[i] ? argv[i] : "NULL" );
}
printf( "\n" );
return 0;
}
int main( int argc, char **argv)
{
sqlite3 *db;
char *zErrMsg = 0;
int rc;
if ( argc!=3 )
{
fprintf(stderr, "Usage: %s DATABASE SQL-STATEMENT\n" , argv[0]);
return 1;
}
rc = sqlite3_open(argv[1], db);
if ( rc )
{
fprintf(stderr, "Can't open database: %s\n" , sqlite3_errmsg(db));
sqlite3_close(db);
return 1;
}
rc = sqlite3_exec(db, argv[2], callback, 0, zErrMsg);
if ( rc!=SQLITE_OK )
{
fprintf(stderr, "SQL error: %s\n" , zErrMsg);
sqlite3_close(db);
return 1;
}
sqlite3_close(db);
return 0;
}
編譯:
[root@localhost test]# gcc sql.c -o sql -l sqlite3
您可能感興趣的文章:- Android開發(fā)之SQLite的使用方法
- SQLite 中文指南之FAQ
- SQLite中的B-Tree實(shí)現(xiàn)細(xì)節(jié)分析
- sqlite中文亂碼問題原因分析及解決
- SQLite3中的日期時(shí)間函數(shù)使用小結(jié)
- sqlite3 top的查詢及l(fā)imit語法介紹
- SQLite優(yōu)化方法
- SQLite 錯(cuò)誤碼整理
- sQlite常用語句以及sQlite developer的使用與注冊(cè)