微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦！

SQlite数据库的C编程接口六 返回值和错误码Result Codes and Error Codes

分类：Sqlite作者：编程之家

标准码（StandardCodes）

下面是标准的返回值和错误码定义：

[cpp] view plain copy
  1. #definesqlITE_OK0/*Successfulresult*/
  2. /*beginning-of-error-codes*/
  3. #definesqlITE_ERROR1/*sqlerrorormissingdatabase*/
  4. #definesqlITE_INTERNAL2/*Internallogicerrorinsqlite*/
  5. #definesqlITE_PERM3/*Accesspermissiondenied*/
  6. #definesqlITE_ABORT4/*Callbackroutinerequestedanabort*/
  7. #definesqlITE_BUSY5/*Thedatabasefileislocked*/
  8. #definesqlITE_LOCKED6/*Atableinthedatabaseislocked*/
  9. #definesqlITE_NOMEM7/*Amalloc()Failed*/
  10. #definesqlITE_READONLY8/*Attempttowriteareadonlydatabase*/
  11. #definesqlITE_INTERRUPT9/*Operationterminatedbysqlite3_interrupt()*/
  12. #definesqlITE_IOERR10/*SomekindofdiskI/Oerroroccurred*/
  13. #definesqlITE_CORRUPT11/*Thedatabasediskimageismalformed*/
  14. #definesqlITE_NOTFOUND12/*UnkNownopcodeinsqlite3_file_control()*/
  15. #definesqlITE_FULL13/*InsertionFailedbecausedatabaseisfull*/
  16. #definesqlITE_CANTOPEN14/*Unabletoopenthedatabasefile*/
  17. #definesqlITE_PROTOCOL15/*Databaselockprotocolerror*/
  18. #definesqlITE_EMPTY16/*Databaseisempty*/
  19. #definesqlITE_SCHEMA17/*Thedatabaseschemachanged*/
  20. #definesqlITE_TOOBIG18/*StringorBLOBexceedssizelimit*/
  21. #definesqlITE_CONSTRAINT19/*Abortduetoconstraintviolation*/
  22. #definesqlITE_MISMATCH20/*Datatypemismatch*/
  23. #definesqlITE_MISUSE21/*Libraryusedincorrectly*/
  24. #definesqlITE_NOLFS22/*UsesOSfeaturesnotsupportedonhost*/
  25. #definesqlITE_AUTH23/*Authorizationdenied*/
  26. #definesqlITE_FORMAT24/*Auxiliarydatabaseformaterror*/
  27. #definesqlITE_RANGE25/*2ndparametertosqlite3_bindoutofrange*/
  28. #definesqlITE_NOTADB26/*Fileopenedthatisnotadatabasefile*/
  29. #definesqlITE_ROW100/*sqlite3_step()hasanotherrowready*/
  30. #definesqlITE_DONE101/*sqlite3_step()hasfinishedexecuting*/
  31. /*end-of-error-codes*/

其中有些常量只由具体的某个函数返回，比如sqlITE_RANGE只会由sqlite3_bind_xxx函数返回。还有一些常量，比如sqlITE_ERROR只能说明函数在执行过程中发生了错误，但无法知道错误发生的原因。

sqlITE_MISUSE代表API被误用。比如一条语句在sqlite3_step函数执行之后，没有被重置之前，再次给其绑定参数，这时bind函数就会返回sqlITE_MISUSE。

扩展码（ExtendedCodes）

标准错误码对于错误发生的原因，所提供的信息比较少。所以有时候，我们会使用扩展的错误码。扩展错误码是以标准错误码为基础，其低阶字节就是原本的标准错误码，然后在其高阶字节“或”上附加信息，描述错误发生的细节。

copy
    intsqlite3_extended_result_codes(sqlite3*,intonoff);

因为考虑到客户旧程序的兼容性问题，默认情况下，这些扩展的错误码是没有启用的。程序员可以通过sqlite3_extended_result_codes函数启用或者关闭扩展错误码。

下面是所有的扩展错误码（其中大部分用来描述sqlITE_IOERR）：

copy
    #definesqlITE_IOERR_READ(sqlITE_IOERR|(1<<8))
  1. #definesqlITE_IOERR_SHORT_READ(sqlITE_IOERR|(2<<8))
  2. #definesqlITE_IOERR_WRITE(sqlITE_IOERR|(3<<8))
  3. #definesqlITE_IOERR_FSYNC(sqlITE_IOERR|(4<<8))
  4. #definesqlITE_IOERR_DIR_FSYNC(sqlITE_IOERR|(5<<8))
  5. #definesqlITE_IOERR_TruncATE(sqlITE_IOERR|(6<<8))
  6. #definesqlITE_IOERR_FSTAT(sqlITE_IOERR|(7<<8))
  7. #definesqlITE_IOERR_UNLOCK(sqlITE_IOERR|(8<<8))
  8. #definesqlITE_IOERR_RDLOCK(sqlITE_IOERR|(9<<8))
  9. #definesqlITE_IOERR_DELETE(sqlITE_IOERR|(10<<8))
  10. #definesqlITE_IOERR_BLOCKED(sqlITE_IOERR|(11<<8))
  11. #definesqlITE_IOERR_NOMEM(sqlITE_IOERR|(12<<8))
  12. #definesqlITE_IOERR_ACCESS(sqlITE_IOERR|(13<<8))
  13. #definesqlITE_IOERR_CHECKRESERVEDLOCK(sqlITE_IOERR|(14<<8))
  14. #definesqlITE_IOERR_LOCK(sqlITE_IOERR|(15<<8))
  15. #definesqlITE_IOERR_CLOSE(sqlITE_IOERR|(16<<8))
  16. #definesqlITE_IOERR_DIR_CLOSE(sqlITE_IOERR|(17<<8))
  17. #definesqlITE_IOERR_SHMOPEN(sqlITE_IOERR|(18<<8))
  18. #definesqlITE_IOERR_SHMSIZE(sqlITE_IOERR|(19<<8))
  19. #definesqlITE_IOERR_SHmlock(sqlITE_IOERR|(20<<8))
  20. #definesqlITE_IOERR_SHMMAP(sqlITE_IOERR|(21<<8))
  21. #definesqlITE_IOERR_SEEK(sqlITE_IOERR|(22<<8))
  22. #definesqlITE_LOCKED_SHAREDCACHE(sqlITE_LOCKED|(1<<8))
  23. #definesqlITE_BUSY_RECOVERY(sqlITE_BUSY|(1<<8))
  24. #definesqlITE_CANTOPEN_NOTEMPDIR(sqlITE_CANTOPEN|(1<<8))
  25. #definesqlITE_CORRUPT_VTAB(sqlITE_CORRUPT|(1<<8))
  26. #definesqlITE_READONLY_RECOVERY(sqlITE_READONLY|(1<<8))
  27. #definesqlITE_READONLY_CANTLOCK(sqlITE_READONLY|(2<<8))

Error相关函数（ErrorFunctions）

copy
    intonoff);

针对某个数据库连接，启用或关闭扩展错误码的使用。通过给sqlite3_extended_result_codes函数的第2个参数传递非零值来启用扩展错误码。该函数总是返回sqlITE_OK，没有什么途径可以获取扩展错误码当前是否启用或关闭。

copy
    intsqlite3_errcode(sqlite3*db);

如果某个数据库函数操作没有返回sqlITE_OK，那么可以随后调用该函数获取错误码。默认情况下它返回标准错误码，如果当前数据库连接已经启用了扩展错误码，那么该函数也可能会返回一个扩展的错误码。

copy
    intsqlite3_extended_errcode(sqlite3*db);

与sqlite3_errcode函数类似，只不过该函数只会返回扩展的错误码。

copy
    constchar*sqlite3_errmsg(sqlite3*);
  1. constvoid*sqlite3_errmsg16(sqlite3*);

返回错误码字符串，使用UTF-8或者UTF-16编码。程序员应该在调用这两个函数，获取错误码信息之后立刻使用，或者做一个拷贝。因为下一个数据库操作就可能会导致返回的字符串指针失效。

sqlite错误处理不能够同时处理多个错误，比如某个API函数调用发生了错误，而程序员没有对该错误进行检查处理，那么下一次API函数调用就很可能返回sqlITE_MISUSE，表明程序试图使用一个无效的数据结构。所以程序员应该在每次API函数调用之后检查和处理任何可能发生的错误。

另外，如果多个线程分享同一个数据库连接，最好将核心的API调用和错误处理部分的代码封装在关键代码区（criticalsection）中。程序员可以使用sqlite3_db_mutex函数获取数据库连接的互斥锁指针（一个指向sqlite3_mutex对象的指针）。

V2版本的prepare函数（Preparev2）

下表是原版本的prepare函数和v2版本的prepare函数的比较：

V2版本的prepare函数对于错误处理更简洁，还有上表中列出的关于schema的优点，所以推荐使用v2版本的prepare函数。

事务和错误（TransactionsandErrors）

通常，sqlite操作处于自动提交模式。sqlite自动把每一个sql命令封装进事务中。如果每条语句都被封装进它自己的事务中，那错误恢复就简单了。任何时候只要sqlite发现它自己处于错误状态，只要简单的回滚当前事务就可以了。这样就可以有效的取消当前sql命令，并使数据库回到出错之前的状态。

然而，一旦BEGINTRANSACTION命令执行，sqlite就不在处于自动提交模式。一个事务被打开，将一直保持打开状态直到ENDTRANSACTION或者COMMITTRANSACTION命令执行。这就允许多条sql命令封装进一个事务中，使一系列离散的命令要么全都执行，要么都不执行（原子操作），不过这也限制了sqlite的错误恢复。

当一个显示的（explicit）事务执行过程中遇到一个错误，sqlite试图取消刚刚执行的语句。不幸的是，这并不总是可能的。如果事情很糟，sqlite有时候只能回退整个当前事务，没有其他选择。

最有可能导致回滚的错误是sqlITE_FULL（数据库或磁盘空间已满），sqlITE_IOERR（磁盘IO错误或文件被锁定），sqlITE_BUSY（数据库锁定），sqlITE_NOMEM（内存不足），sqlITE_INTERRUPT（中断）。如果程序正在执行一个显示事务，并且收到这些错误之一，那就要准备好处理可能将发生的事务回滚。

copy
    intsqlite3_get_autocommit(sqlite3*);

通过该函数，可以获取当前的提交状态。如果返回非0值，则数据库处于自动提交（atutoconmit）模式。如果返回0，则数据库正处于一个显示事务之中（thedatabaseiscurrentlyinsideanexplicittransaction）。

如果sqlite数据库被强制做了一次完全事务回滚操作，则数据库将再次变为事务自动提交模式。如果数据库不在自动提交模式，则它肯定处于一个事务之中，表明并不需要回滚。

原文地址：https://www.jb51.cc/sqlite/201355.html

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

Java 嵌入数据处理引擎：SQLite 的挑战者 esProc SPL
SQLite架构简单，又有Json计算能力，有时会承担Json文件/RESTful的计算功能，但SQLite不能直接解析Json文件/RESTful，需要用Java代码硬写，或借助第三方类库，最后再拼成insert语句插入数据表，代码非常繁琐，这里就不展示了。参考前面的代码可知，入库的过程比较麻烦，不能只用SQL，还要借助Java或命令行。SPL是现代的数据计算语言，属于简化的面向对象的语言风格，有对象的概念，可以用点号访问属性并进行多步骤计算，但没有继承重载这些内容，不算彻底的面向对象语言。...
五、使用Python操作数据库
使用Python操作内置数据库SQLite以及MySQL数据库。
AndroidStudio-实现登录界面数据存储在SQLite
登陆界面
一文教会你导出微信聊天记录
破解微信数据库密码，用python导出微信聊天记录
UnitySqlite持久化数据
（Unity）SQLite 是一个软件库，实现了自给自足的、无服务器的、零配置的、事务性的 SQL 数据库引擎。SQLite 是在世界上最广泛部署的 SQL 数据库引擎。SQLite 源代码不受版权限制。本教程将告诉您如何使用 SQLite 编程，并让你迅速上手。.................................
Android用户登陆与注册功能的简单实现SQLite
安卓开发，利用SQLite实现登陆注册功能
SQLite——Java使用SQLite初体验
相比大多数数据库而言，具有等优势，广泛应用于、等领域。
使用SqlSugar连接多个数据库sqlserver，sqlite，mysql
有时候，一个项目只有一个数据库，比如只有SQLite，或者MySQL数据库，那么我们只需要使用一个固定的数据库即可。但是一个项目如果写好了，有多个用户使用，但是多个用户使用不同的数据库，这个时候，我们就需要把软件设计成可以连接多个数据库的模式，用什么数据库，就配置什么数据库即可。4.Users实体类，这个实体类要和数据库一样的，形成一一对应的关系。11.Sqlite数据库，需要在代码里面创建数据库，建立表，再建立数据。8.我们开启MySQL数据库，然后进行调试，看程序的结果。2.安装SqlSugar。
基于Android的背单词软件【源码+文档+答辩PPT】
基于Android的背单词软件，功能强大完整。
python ——操作sqlite 数据库
SQLite，是一款轻型的数据库，是遵守ACID的关系型数据库管理系统。说白了就是使用起来轻便简单，
苹果市值2025年有望达4万亿美元
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot