在C++項目中使用SQLite3數(shù)據(jù)庫的全過程

更新時間：2025年11月03日 09:35:54 作者：Humbunklung

本文檔介紹如何在 C++ 項目中使用 SQLite3 數(shù)據(jù)庫,假設通過 vcpkg 安裝了 SQLite3,因本機為Windows環(huán)境,為方便,用了本機的Visual Studio 2022 創(chuàng)建cmake項目,需要的朋友可以參考下

安裝 SQLite3

首先，確保你已經(jīng)通過 vcpkg 安裝了 SQLite3。可以使用以下命令進行安裝：

vcpkg install sqlite3

配置 CMakes

在 CMakeLists.txt 文件中，添加以下內容以找到并鏈接 SQLite3：

find_package(SQLite3 REQUIRED)

target_link_libraries(your_target PRIVATE SQLite::SQLite3)

實際上，由于我用了Visual Studio 2022，我的cmake項目結構如下：

use-sqlite3目錄下的CMakeLists.txt文件我修改如下：

# CMakeList.txt: use-sqlite3 的 CMake 項目，在此處包括源代碼并定義
# 項目特定的邏輯。
#
SET(CMAKE_TOOLCHAIN_FILE "D:/tools/vcpkg/scripts/buildsystems/vcpkg.cmake")
include("D:/tools/vcpkg/scripts/buildsystems/vcpkg.cmake")
if(DEFINED ENV{VCPKG_DEFAULT_TRIPLET} AND NOT DEFINED VCPKG_TARGET_TRIPLET)
    set(VCPKG_TARGET_TRIPLET "$ENV{VCPKG_DEFAULT_TRIPLET}" CACHE STRING "" FORCE)
endif()
# 將源代碼添加到此項目的可執(zhí)行文件。
add_executable (use-sqlite3 "use-sqlite3.cpp" "use-sqlite3.h")

if (CMAKE_VERSION VERSION_GREATER 3.12)
  set_property(TARGET use-sqlite3 PROPERTY CXX_STANDARD 20)
endif()

# TODO: 如有需要，請?zhí)砑訙y試并安裝目標。

find_package(SQLite3 REQUIRED)

target_link_libraries(use-sqlite3 PRIVATE SQLite::SQLite3)

使用 SQLite3

在你的 C++ 代碼中，可以包含 SQLite3 的頭文件并開始使用它：

// 示例代碼

// use-sqlite3.cpp: 定義應用程序的入口點。
//

#include "use-sqlite3.h"
#include "sqlite3.h"

using namespace std;

int main()
{
	sqlite3* db;
	char* zErrMsg = 0;
	int rc;

	// 打開數(shù)據(jù)庫
	rc = sqlite3_open("example.db", &db);
	if (rc) {
		std::cerr << "Can't open database: " << sqlite3_errmsg(db) << std::endl;
		return(0);
	}
	else {
		std::cout << "Opened database successfully" << std::endl;
	}

	// 創(chuàng)建表
	const char* sqlCreateTable = "CREATE TABLE IF NOT EXISTS test( "
		"id INTEGER PRIMARY KEY, "
		"name TEXT NOT NULL);";
	rc = sqlite3_exec(db, sqlCreateTable, 0, 0, &zErrMsg);
	if (rc != SQLITE_OK) {
		std::cerr << "SQL error: " << zErrMsg << std::endl;
		sqlite3_free(zErrMsg);
	}
	else {
		std::cout << "Table created successfully" << std::endl;
	}

	// 插入數(shù)據(jù)
	const char* sqlInsert = "INSERT INTO test(name) VALUES ('Alice');";
	rc = sqlite3_exec(db, sqlInsert, 0, 0, &zErrMsg);
	if (rc != SQLITE_OK) {
		std::cerr << "SQL error: " << zErrMsg << std::endl;
		sqlite3_free(zErrMsg);
	}
	else {
		std::cout << "Records created successfully" << std::endl;
	}

	const char* sqlUpdate = "UPDATE test SET name = 'Bob' WHERE id = 2;";
	rc = sqlite3_exec(db, sqlUpdate, 0, 0, &zErrMsg);
	if (rc != SQLITE_OK) {
		std::cerr << "SQL error: " << zErrMsg << std::endl;
		sqlite3_free(zErrMsg);
	}
	else {
		std::cout << "Record updated successfully" << std::endl;
	}

	// 查詢數(shù)據(jù)
	const char* sqlSelect = "SELECT * FROM test;";
	rc = sqlite3_exec(db, sqlSelect, [](void* NotUsed, int argc, char** argv, char** azColName) {
		for (int i = 0; i < argc; i++) {
			std::cout << azColName[i] << " = " << (argv[i] ? argv[i] : "NULL") << std::endl;
		}
		std::cout << std::endl;
		return 0;
		}, 0, &zErrMsg);
	if (rc != SQLITE_OK) {
		std::cerr << "SQL error: " << zErrMsg << std::endl;
		sqlite3_free(zErrMsg);
	}
	else {
		std::cout << "Operation done successfully" << std::endl;
	}

	// 關閉數(shù)據(jù)庫
	sqlite3_close(db);
	std::cout << "Database closed successfully" << std::endl;

	return 0;
}

運行效果如下：