声明:本SQLite源码剖析系列为刘兴(http://deepfuture.iteye.com/)原创,未经笔者授权,任何人和机构不能转载
/*
** Many people are failing to set -DNDEBUG=1 when compiling SQLite.
** Setting NDEBUG makes the code smaller and run faster. So the following
** lines are added to automatically set NDEBUG unless the -DSQLITE_DEBUG=1
** option is set. Thus NDEBUG becomes an opt-in rather than an opt-out
** feature.
*/
// NDEBUG设置能使代码更小,且运行地更快
#if !defined(NDEBUG) && !defined(SQLITE_DEBUG)
# define NDEBUG 1
#endif
/*
** The testcase() macro is used to aid in coverage testing. When
** doing coverage testing, the condition inside the argument to
** testcase() must be evaluated both true and false in order to
** get full branch coverage. The testcase() macro is inserted
** to help ensure adequate test coverage in places where simple
** condition/decision coverage is inadequate. For example, testcase()
** can be used to make sure boundary values are tested. For
** bitmask tests, testcase() can be used to make sure each bit
** is significant and used at least once. On switch statements
** where multiple cases go to the same block of code, testcase()
** can insure that all cases are evaluated.
**
*/
//在覆盖测试时使用testcase()宏
#ifdef SQLITE_COVERAGE_TEST
SQLITE_PRIVATE void sqlite3Coverage(int);
# define testcase(X) if( X ){ sqlite3Coverage(__LINE__); }
#else
# define testcase(X)
#endif
/*
** The TESTONLY macro is used to enclose variable declarations or
** other bits of code that are needed to support the arguments
** within testcase() and assert() macros.
*/
// TESTONLY将变量声明或需要使用testcase()和assert()宏
//的参数的代码片断包围
#if !defined(NDEBUG) || defined(SQLITE_COVERAGE_TEST)
# define TESTONLY(X) X
#else
# define TESTONLY(X)
#endif
/*
** Sometimes we need a small amount of code such as a variable initialization
** to setup for a later assert() statement. We do not want this code to
** appear when assert() is disabled. The following macro is therefore
** used to contain that setup code. The "VVA" acronym stands for
** "Verification, Validation, and Accreditation". In other words, the
** code within VVA_ONLY() will only run during verification processes.
*/
//在写一段代码如变量初始化时,需要设置assert()语句进行验证,
//当assert()被禁止时,我们不希望看到这些代码
// 包括VVA_ONLY()的代码仅在验证后才运行
#ifndef NDEBUG
# define VVA_ONLY(X) X
#else
# define VVA_ONLY(X)
#endif
/*
** ALWAYS和NEVER宏环绕boolean表达式,分别为true或false,
**代码中的这些表达式能被完全忽略,但他们在少数情况下被用于提高SQLITE
**异常恢复能力,使代码自修复。
** The ALWAYS and NEVER macros surround boolean expressions which
** are intended to always be true or false, respectively. Such
** expressions could be omitted from the code completely. But they
** are included in a few cases in order to enhance the resilience
** of SQLite to unexpected behavior - to make the code "self-healing"
** or "ductile" rather than being "brittle" and crashing at the first
** hint of unplanned behavior.
** ALWAYS和NEVER可被用于防御代。当做覆盖测试时,
**ALWAYS和NEVER被硬编码为true和false,
**无法访问的代码,不能算作未经测试的代码。
** In other words, ALWAYS and NEVER are added for defensive code.
**
** When doing coverage testing ALWAYS and NEVER are hard-coded to
** be true and false so that the unreachable code then specify will
** not be counted as untested code.
*/
#if defined(SQLITE_COVERAGE_TEST)
# define ALWAYS(X) (1)
# define NEVER(X) (0)
#elif !defined(NDEBUG)
# define ALWAYS(X) ((X)?1:(assert(0),0))
# define NEVER(X) ((X)?(assert(0),1):0)
#else
# define ALWAYS(X) (X)
# define NEVER(X) (X)
#endif
/*
** The macro unlikely() is a hint that surrounds a boolean
** expression that is usually false. Macro likely() surrounds
** a boolean expression that is usually true. GCC is able to
** use these hints to generate better code, sometimes.
*/
// 对于包围的boolean表达式,unlikely()为false,likely()为true
// GCC有时可使用这些暗示产生更好的代码。
#if defined(__GNUC__) && 0
# define likely(X) __builtin_expect((X),1)
# define unlikely(X) __builtin_expect((X),0)
#else
# define likely(X) !!(X)
# define unlikely(X) !!(X)
#endif
分享到:
相关推荐
本文将对Android SqliteManager的源码进行深入剖析,以揭示其核心机制。 首先,SQLiteManager主要负责创建、打开、关闭数据库,以及执行SQL语句等操作。源码中,我们可以看到SQLiteOpenHelper子类的实现,这是...
本文将深入剖析SQLite3的源代码,并重点关注其核心组件及实现机制,旨在帮助读者更好地理解SQLite3的工作原理及其在实际开发中的应用。 #### 2. SQLite3程序结构概览 SQLite3的核心功能通过一系列紧密耦合的源代码...
9. **附录与源码分析**:随书源码提供了对SQLite源代码的深度剖析,有助于开发者深入了解其内部实现,并进行二次开发或定制。 通过阅读《SQLite权威指南》第二版,读者不仅可以掌握SQLite的日常使用,还能了解到更...
本文将对Android SqliteManager的源码进行深度剖析,帮助开发者理解其内部机制,提升数据库管理能力。 首先,SqliteManager的核心功能是与SQLite数据库进行交互。在源码中,我们能看到它使用了`SQLiteDatabase`类...
首先,Android联系人APP源码剖析这一标题表明本文将重点讲解Android平台上联系人管理应用的源码,尤其是基于Android 2.3版本进行的分析。通过这种剖析,开发者可以更好地理解如何定制及使用源码,以构建或优化联系人...
【标题】"java源码剖析-FrackingData:面向FracFocus数据分析的存储库。SQL(例如SQLite,PostgreSQL,SQLSe" 这个标题表明我们正在探讨一个Java开发的开源项目,名为FrackingData,它是专门为处理FracFocus数据设计...
4. **数据库管理**:客户端通常会存储用户信息、聊天记录等数据,可能会用到SQLite数据库,进行本地数据的存储和检索。 5. **Android UI设计**:源码中的XML布局文件和Java代码会展示如何构建Android用户界面,包括...
本文将深入剖析Notepad源码,揭示其背后的编程原理和技术细节。 一、数据库管理 Notepad的核心功能之一是存储和管理笔记,这涉及到Android中的SQLite数据库。源码中可以看到,Notepad使用SQLiteOpenHelper子类来...
本文将深入剖析一款名为“jchat4”的Android手机聊天程序的源码,帮助开发者理解和学习如何构建一个完整的聊天应用。 首先,我们要明白的是,一个聊天应用程序的核心功能包括用户注册与登录、消息发送与接收、群组...
本篇将深入剖析Android源码中的MyContacts通讯录源码,通过分析其设计思路、实现机制以及关键组件,来探讨Android通讯录应用的核心技术。 首先,通讯录是Android系统中的基础服务之一,MyContacts则是Android提供的...
本篇文章将对标题为“简单的通讯录源码.zip”的压缩包进行深入剖析,主要关注其在安卓平台上的实现,并讨论其中可能涉及的核心技术与功能实现。 首先,该源码的标签明确指出这是一个针对安卓平台的生活应用源码。这...
《深入剖析Android 4.0.3源码》 Android 4.0.3,代号Ice Cream Sandwich(冰淇淋三明治),是Android系统发展的一个重要里程碑,它为开发者提供了更多的功能和优化,提升了用户体验。这份源码是理解Android系统工作...
通过深入剖析这份源码,开发者可以学习到如何构建一个功能完备、用户体验良好的词典应用。 1. **项目结构**: - 项目通常由多个模块组成,包括主应用模块、词典数据模块、网络请求模块等。源码会展示如何划分模块...
《深入剖析xUtils源码:探索Android开发利器的内在奥秘》 xUtils是一个功能强大的Android开发库,它集成了网络请求、图片加载、数据库操作、视图注入等多个功能,大大简化了Android开发者的工作。本篇文章将围绕...
《深入剖析Android应用:基于新浪微博客户端源码》 在Android开发领域,研究知名应用的源码是提升技术能力的重要途径之一。本篇文章将基于“android应用源码(精)新浪微博客户端源码.zip”这一资源,深入探讨其中...
《深入剖析Android源码——以WordPress for Android为例》 Android操作系统以其开源、可定制的特性,在全球范围内广受欢迎,尤其在移动应用开发领域占据主导地位。对于开发者来说,理解Android源码是提升技术水平、...
本篇文章将围绕“Android高级应用源码-一个短信应用源码.zip”进行详细剖析,旨在帮助开发者从源码中汲取养分,提升对Android系统级短信应用的理解和实战技能。 首先,我们要明确的是,短信应用是Android操作系统中...
《深入剖析Android 4.0源码》 Android 4.0,又称为Ice Cream Sandwich(简称ICS),是Google发布的一个重要版本,它在Android操作系统的发展历程中扮演了承上启下的角色,既继承了早期版本的优点,又为后续版本奠定...
《 Memo单词本2.5源码分析:深入理解Android应用开发》 ...通过深入剖析源码,我们不仅能了解一个应用的工作原理,还能学习到如何将理论知识转化为实际的代码,这对于个人的职业发展具有极大的推动作用。
本文将深度剖析小米便签的源码,带你探索这一应用背后的开发技术。 1. **项目结构分析** - `MiCode-Notes-6cbf71d`是小米便签项目的Git仓库分支,这表明小米便签的开发团队采用了Git进行版本控制,确保代码的稳定...