Man page - ecpg(1)

Packages contains this manual

Package:  libecpg-dev
apt-get install libecpg-dev

Manuals in package:
• ecpg(1)
Documentations in package:
• libecpg-dev

Available languages:

en zh_TW zh_CN

Manual

ECPG

NAME
SYNOPSIS
DESCRIPTION 描 述
OPTIONS 選 項
NOTES 注 意
EXAMPLES 例 子
譯 者
跋

---

NAME

ecpg - 嵌 入 的 SQL C 預 處 理 器

SYNOPSIS

ecpg [ option ... ] file ...

DESCRIPTION 描 述

ecpg 是 一 個 嵌 入 的 用 於 C 語 言 的 SQL 預 編 譯 器 。 它 把 嵌 有 SQL 語 句 的 C 程 式 透 過 將 SQL 呼 叫 替 換 成 特 殊 的 函 式 呼 叫 的 方 法 轉 換 成 普 通 的 C 程 式 碼 。 然 後 輸 出 的 檔 案 就 可 以 用 任 何 C 編 譯 工 具 進 行 處 理 。

clusterdb 將 把 命 令 列 上 給 出 的 每 個 輸 入 檔 案 轉 換 成 對 應 的 C 輸 出 檔 案 。 輸 入 檔 案 最 好 有 .pgc 的 副 檔 名 ， 這 樣 ， 這 個 擴 充 套 件 將 被 替 換 成 .c 來 決 定 輸 出 檔 名 。 如 果 輸 入 檔 案 的 擴 充 套 件 不 是 .pgc， 那 麼 輸 出 檔 名 將 透 過 在 全 檔 名 後 面 附 加 .c 來 生 成 。 輸 出 檔 名 也 可 以 用 -o 選 項 覆 蓋 。

本 手 冊 頁 並 不 描 述 嵌 入 的 SQL 語 句 ， 參 閱 Chapter 29 獲 更 多 資 訊 。

OPTIONS 選 項

clusterdb 接 受 下 列 命 令 列 引 數 ：

-c

為 SQL 程 式 碼 自 動 生 成 某 種 C 程 式 碼 。 目 前 ， 這 個 選 項 可 以 用 於 EXEC SQL TYPE。

-C mode

設 定 一 個 相 容 模 式 。 mode 可 以 是 INFORMIX 或 者 INFORMIX_SE。

-D symbol

定 義 一 個 C 預 編 譯 器 符 號 。

-i

同 時 也 分 析 系 統 包 含 檔 案 。

-I include-path

宣 告 一 個 附 加 的 包 含 路 徑 。 用 於 尋 找 透 過 EXEC SQL INCLUDE 包 含 的 檔 案 。 預 設 是 .（ 當 前 目 錄 ） ， /usr/local/include， 在 編 譯 時 定 義 的 PostgreSQL 包 含 路 徑 （ 預 設 ： /usr/local/pgsql/include） 和 /usr/include。 順 序 如 上 。

-o filename

宣 告 ecpg應 該 把 它 的 所 有 輸 出 寫 到 給 出 的 filename裡 。

-t

開 啟 自 動 提 交 模 式 。 在 這 種 模 式 象 ， 每 個 查 詢 都 自 動 提 交 ， 除 非 它 是 包 圍 在 一 個 明 確 的 事 務 塊 中 。 在 預 設 模 式 下 ， 命 令 只 是 在 發 出 EXEC SQL COMMIT 的 時 候 提 交 。

-v

列 印 額 外 的 資 訊 ， 包 括 版 本 和 包 含 路 徑 。

--help

顯 示 一 個 命 令 用 法 的 簡 單 摘 要 ， 然 後 退 出 。

--version

顯 示 版 本 資 訊 ， 然 後 退 出 。

NOTES 注 意

在 編 譯 預 處 理 的 C 程 式 碼 檔 案 的 時 候 ， 編 譯 器 需 要 能 夠 找 到 PostgreSQL 包 含 目 錄 裡 面 的 ECPG 標 頭 檔 案 。 因 此 ， 我 們 在 呼 叫 編 譯 器 的 時 候 可 能 需 要 使 用 -I （ 比 如 ， -I/usr/local/pgsql/include） 。
使 用 了 嵌 入 SQL 的 C 程 式 碼 必 須 和 libecpg 庫 連 結 ， 比 如 ， 使 用 這 樣 的 連 結 選 項 ： -L/usr/local/pgsql/lib -lecpg
這 些 目 錄 的 實 際 值 可 以 透 過 pg_config (1) 找 到 。

EXAMPLES 例 子

如 果 你 有 一 個 叫 prog1.pgc 的 嵌 入 SQL 的 C 原 始 碼 ， 你 可 以 用 下 面 的 命 令 序 列 建 立 一 個 可 執 行 程 式 ：

ecpg prog1.pgc
cc -I/usr/local/pgsql/include -c prog1.c
cc -o prog1 prog1.o -L/usr/local/pgsql/lib -lecpg

譯 者

Postgresql 中 文 網 站 何 偉 平 <laser@pgsqldb.org>

跋

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。
中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh

---