首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

Obtain Values For URI Parameters

const char *sqlite3_uri_parameter(const char *zFilename, const char *zParam);
int sqlite3_uri_boolean(const char *zFile, const char *zParam, int bDefault);
sqlite3_int64 sqlite3_uri_int64(const char*, const char*, sqlite3_int64);

这些是对 VFS 实现有用的实用程序例程,用于检查数据库文件是否为包含特定查询参数的 URI,如果是,则获取该查询参数的值。

如果当 xOpen() 的 flags 参数设置了一个或多个 SQLITE_OPEN_URI 或 SQLITE_OPEN_MAIN_DB 位并且 P 是查询参数的名称时,F 是传递到 VFS 实现的 xOpen()方法中的数据库文件名指针,则 sqlite3_uri_parameter F,P)返回 P 参数的值,如果它存在,则返回 P 的值;如果 P 没有作为查询参数出现在F上,则返回 NULL 指针。如果 P 是查询参数 F 没有显式值,则 sqlite3_uri_parameter(F,P)返回一个指向空字符串的指针。

sqlite3_uri_boolean(F,P,B)例程假定 P 是一个布尔参数,并根据P的值返回 true(1)或 false(0).sqlite3_uri_boolean(F,P,B) 例程返回true(1)如果查询参数 P 的值在任何情况下是“是”,“是”或“开”中的一个,或者如果该值以非零数字开始。如果查询参数P的值在任何情况下都是 “no”,“false” 或 “off” 之一,或者如果值以数字零开始,则 sqlite3_uri_boolean(F,P,B)例程返回 false(0)。如果P不是F上的查询参数,或者 P 的值不符合上述任何一个,则 sqlite3_uri_boolean(F,P,B)返回(B!= 0)。

sqlite3_uri_int64(F,P,D)例程将 P的值转换为64位有符号整数并返回该整数,如果P不存在则返回 D. 如果 P 的值不是整数,则返回零。

如果F是一个 NULL 指针,则 sqlite3_uri_parameter(F,P)返回 NULL,并且 sqlite3_uri_boolean(F,P,B)返回 B. 如果 F 不是一个 NULL 指针,并且不是 SQLite 传入 xOpen VFS 的数据库文件路径名指针方法,那么这个例程的行为是不确定的,可能是不可取的。

扫码关注腾讯云开发者

领取腾讯云代金券