FindODBC

於 3.12 版本新增。

尋找開放資料庫連接 (ODBC) 的 include 目錄和函式庫。

在 Windows 上，使用 Visual Studio 建置時，此模組假設 ODBC 函式庫由可用的 Windows SDK 提供。

在 Unix 上，此模組允許搜尋由 unixODBC 或 iODBC 實作的 ODBC API 所提供的 ODBC 函式庫。此模組會讀取關於設定程式位置的提示。

ODBC_CONFIG

odbc_config 或 iodbc-config 程式的位置

否則，此模組會嘗試尋找設定程式，首先從 unixODBC，然後從 iODBC。如果找不到設定程式，此模組會在已知位置的清單中搜尋 ODBC 標頭和函式庫。

匯入的目標

此模組定義下列 IMPORTED 目標

ODBC::ODBC

如果找到，用於使用 ODBC 函式庫的匯入目標。

結果變數

ODBC_FOUND

如果找到 ODBC 函式庫，則設為 true，否則為 false 或未定義。

ODBC_INCLUDE_DIRS

列於一個變數中，供 ODBC 用戶端使用的 include 目錄路徑。在 Windows 上可能為空，因為對應於預期 Windows SDK 的 include 目錄已在編譯環境中可用。

ODBC_LIBRARIES

要連結以使用 ODBC 的函式庫路徑。在 Windows 上可能只是一個函式庫名稱，因為對應於預期 Windows SDK 的函式庫目錄已在編譯環境中可用。

ODBC_CONFIG

如果找到或指定，則為 unixODBC 或 iODBC 設定程式的路徑。

快取變數

對於希望編輯和控制模組行為的使用者，此模組會從以下變數讀取有關搜尋位置的提示

ODBC_INCLUDE_DIR

包含 sql.h 標頭的 ODBC include 目錄路徑。

ODBC_LIBRARY

要連結的 ODBC 函式庫路徑。

這些變數不應由專案程式碼直接使用。

限制

在 Windows 上，此模組不會搜尋 iODBC。在 Unix 上，除了使用 ODBC_CONFIG 提供設定程式位置外，沒有辦法偏好 unixODBC 而不是 iODBC，反之亦然。此模組不允許搜尋特定的 ODBC 驅動程式。