FindODBC

新增於版本 3.12。

尋找 Open Database Connectivity (ODBC) 包含目錄和函式庫。

在 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 用戶端使用。在 Windows 上可能為空，因為對應於預期 Windows SDK 的包含目錄已在編譯環境中可用。

ODBC_LIBRARIES

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

ODBC_CONFIG

unixODBC 或 iODBC 組態程式的路徑 (如果找到或指定)。

快取變數

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

ODBC_INCLUDE_DIR

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

ODBC_LIBRARY

要連結的 ODBC 函式庫路徑。

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

限制

在 Windows 上，此模組不會搜尋 iODBC。在 Unix 上，除了使用 ODBC_CONFIG 提供組態程式位置外，沒有其他方法可以優先選擇 unixODBC 而不是 iODBC，反之亦然。此模組不允許搜尋特定的 ODBC 驅動程式。