SQLite 模糊查詢
一、示例說明:本文演示如何在 iOS 中用 SQLite 實現模糊查詢。
1. 新建一個繼承自 NSObject 的模型:

// YYPerson.h #import <Foundation/Foundation.h> @interface YYPerson : NSObject @property (nonatomic, assign) int ID; @property (nonatomic, copy) NSString *name; @property (nonatomic, assign) int age; @end
2. 新建一個工具類來管理模型:

// YYPersonTool.h #import <Foundation/Foundation.h> @class YYPerson; @interface YYPersonTool : NSObject /** 保存一個聯系人 */ + (void)save:( YYPerson*)person; /** 查詢所有聯系人 */ + (NSArray *)query; + (NSArray *)queryWithCondition:(NSString *)condition; @end
YYPersonTool.m 是核心,涵蓋了數據庫初始化、建表、插入與模糊查詢:
// YYPersonTool.m
#import "YYPersonTool.h"
#import "YYPerson.h"
#import <sqlite3.h>
@implementation YYPersonTool
static sqlite3 *_db;
// 首先需要有數據庫
+(void)initialize
{
// 獲得數據庫文件路徑
NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName=[doc stringByAppendingPathComponent:@"person.sqlite"];
// OC 字符串轉 C 字符串
const char *cfileName=fileName.UTF8String;
// 1. 打開數據庫(不存在時會自動創建)
int result = sqlite3_open(cfileName, &_db);
if (result==SQLITE_OK) {
NSLog(@"成功打開數據庫");
// 2. 創建表
const char *sql="CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);";
char *errmsg=NULL;
result = sqlite3_exec(_db, sql, NULL, NULL, &errmsg);
if (result==SQLITE_OK) {
NSLog(@"創表成功");
} else {
printf("創表失敗---%s",errmsg);
}
} else {
NSLog(@"打開數據庫失敗");
}
}
// 保存一條數據
+(void)save:(YYPerson *)person
{
NSString *sql=[NSString stringWithFormat:@"INSERT INTO t_person (name,age) VALUES ('%@',%d);",person.name,person.age];
char *errmsg=NULL;
sqlite3_exec(_db, sql.UTF8String, NULL, NULL, &errmsg);
if (errmsg) {
NSLog(@"插入數據失敗--%s",errmsg);
} else {
NSLog(@"插入數據成功");
}
}
+(NSArray *)query
{
return [self queryWithCondition:@""];
}
// 模糊查詢
+(NSArray *)queryWithCondition:(NSString *)condition
{
NSMutableArray *persons=nil;
NSString *NSsql=[NSString stringWithFormat:@"SELECT id,name,age FROM t_person WHERE name like '%%%@%%' ORDER BY age ASC;",condition];
NSLog(@"%@",NSsql);
const char *sql=NSsql.UTF8String;
sqlite3_stmt *stmt=NULL;
// 進行查詢前的准備工作
if (sqlite3_prepare_v2(_db, sql, -1, &stmt, NULL)==SQLITE_OK) {
NSLog(@"查詢語句沒有問題");
persons=[NSMutableArray array];
// 每調用一次 sqlite3_step,stmt 就指向下一條記錄
while (sqlite3_step(stmt)==SQLITE_ROW) {
int ID=sqlite3_column_int(stmt, 0);
const unsigned char *name=sqlite3_column_text(stmt, 1);
int age=sqlite3_column_int(stmt, 2);
YYPerson *p=[[YYPerson alloc]init];
p.ID=ID;
p.name=[NSString stringWithUTF8String:(const char *)name];
p.age=age;
[persons addObject:p];
}
} else {
NSLog(@"查詢語句有問題");
}
return persons;
}
@end
3. 在 storyboard 中刪除原有控制器,放一個導航控制器和 UITableViewController 並關聯,讓主控制器直接繼承自 UITableViewController:

// YYViewController.m
#import "YYViewController.h"
#import "YYPerson.h"
#import "YYPersonTool.h"
@interface YYViewController ()<UISearchBarDelegate>
@property(nonatomic,strong)NSArray *persons;
@end
@implementation YYViewController
#pragma mark- 懶加載
-(NSArray *)persons
{
if (_persons==nil) {
_persons=[YYPersonTool query];
}
return _persons;
}
// 1. 初始化方法中添加搜索框
- (void)viewDidLoad
{
[super viewDidLoad];
UISearchBar *search=[[UISearchBar alloc]init];
search.frame=CGRectMake(0, 0, 300, 44);
search.delegate=self;
self.navigationItem.titleView=search;
}
// 2. 設置 tableView 數據
-(NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
return self.persons.count;
}
-(UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
static NSString *ID=@"ID";
UITableViewCell *cell=[tableView dequeueReusableCellWithIdentifier:ID];
if (cell==nil) {
cell=[[UITableViewCell alloc]initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
}
YYPerson *person=self.persons[indexPath.row];
cell.textLabel.text=person.name;
cell.detailTextLabel.text=[NSString stringWithFormat:@"年齡 %d",person.age];
return cell;
}
- (IBAction)add:(UIBarButtonItem *)sender {
// 初始化一些假數據
NSArray *names = @[@"西門抽血", @"西門抽筋", @"西門抽風", @"西門吹雪", @"東門抽血", @"東門抽筋", @"東門抽風", @"東門吹雪", @"北門抽血", @"北門抽筋", @"南門抽風", @"南門吹雪"];
for (int i = 0; i<20; i++) {
YYPerson *p = [[YYPerson alloc] init];
p.name = [NSString stringWithFormat:@"%@-%d", names[arc4random_uniform(names.count)], arc4random_uniform(100)];
p.age = arc4random_uniform(20) + 20;
[YYPersonTool save:p];
}
}
#pragma mark- 搜索框代理方法
-(void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText
{
self.persons=[YYPersonTool queryWithCondition:searchText];
[self.tableView reloadData];
[searchBar resignFirstResponder];
}
@end
實現效果:


二、關於模糊查詢語句的說明
這句 SQL 值得細看:
SELECT id,name,age FROM t_person WHERE name like '%%%@%%' ORDER BY age ASC;
注意:name like '西門' 相當於 name = '西門';而 name like '%西%' 才是真正的模糊搜索,表示字符串中間包含「西」、左右兩側可以是任意內容。只是在 stringWithFormat: 裡,% 是轉義字符,兩個 % 才代表一個真正的 %。

一、核心 C 接口函數
1. 打開數據庫 sqlite3_open(filename, &db):filename 是數據庫文件路徑,db 是數據庫實例;
2. 執行任意 SQL 語句 sqlite3_exec(db, sql, callback, arg, &errmsg):可執行創表、更新、插入、刪除等,errmsg 用於接收錯誤信息;
3. 檢查 SQL 合法性 sqlite3_prepare_v2(db, zSql, nByte, &ppStmt, &pzTail):查詢前的准備,返回 SQLITE_OK 表示語句無誤,ppStmt 是後續取數據用的語句實例;
4. 逐行查詢 sqlite3_step(stmt):每調用一次指向下一條記錄,查到一行返回 SQLITE_ROW;
5. 取字段值 sqlite3_column_*(字段下標從 0 開始):sqlite3_column_int 取整型、sqlite3_column_double 取浮點、sqlite3_column_int64 取长整型、sqlite3_column_text 取字符串、sqlite3_column_blob 取二進制。
二、SQLite 編碼要點
1. 打開與關閉:sqlite3_open 會根據路徑打開數據庫,不存在則新建,返回 SQLITE_OK 表示成功;路徑必須以 C 字符串傳入;用完調 sqlite3_close(db) 關閉。
2. 執行不返回數據的語句(如建表、事務):用 sqlite3_exec,還可執行 begin transaction、rollback、commit 等事務語句。
3. 帶占位符插入(更安全、可防注入):
char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
sqlite3_bind_text(stmt, 1, "母雞", -1, NULL);
sqlite3_bind_int(stmt, 2, 27);
}
if (sqlite3_step(stmt) != SQLITE_DONE) {
NSLog(@"插入數據錯誤");
}
sqlite3_finalize(stmt);
說明:占位符位置從 1 開始(不是 0);C 字符串可用 -1 代替長度;sqlite3_step 返回 SQLITE_DONE 代表執行成功;sqlite3_finalize 用於銷毀語句對象。
4. 查詢數據:
char *sql = "select id,name,age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
int _id = sqlite3_column_int(stmt, 0);
char *_name = (char *)sqlite3_column_text(stmt, 1);
NSString *name = [NSString stringWithUTF8String:_name];
int _age = sqlite3_column_int(stmt, 2);
NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
}
}
sqlite3_finalize(stmt);
sqlite3_step 返回 SQLITE_ROW 表示遍歷到一條新記錄,再用 sqlite3_column_* 按索引取出各字段值即可。