# ecpg ## Name ecpg?--?嵌入的 SQL C 預處理器 ## Synopsis `ecpg` [`_option_`...] `_file_`... ## 描述 `ecpg`是一個嵌入的用于 C 語言的 SQL 預編譯器。 它把嵌有 SQL 語句的 C 程序通過將 SQL 調用替換成特殊的函數調用的方法轉換成普通的 C 代碼。 然后輸出的文件就可以用任何 C 編譯工具進行處理。 `ecpg`將把命令行上給出的每個輸入文件轉換成對應的 C 輸出文件。 輸入文件最好有`.pgc`擴展名，這樣，這個擴展將被替換成 `.c`來決定輸出文件名。如果輸入文件的擴展不是`.pgc`， 那么輸出文件名將通過在全文件名后面附加`.c`來生成。 輸出文件名也可以用`-o`選項覆蓋。 本手冊頁并不描述嵌入的 SQL 語句，參閱[Chapter 33](#calibre_link-620)獲更多信息。 ## 選項 `ecpg`接受下面命令行參數： `-c` 為 SQL 代碼自動生成某種 C 代碼。目前，這個選項可以用于`EXEC SQL TYPE`。 `-C` `_mode_` 設置一個兼容模式。`_mode_`可以是`INFORMIX` 或`INFORMIX_SE`之一。 `-D` `_symbol_` 定義一個 C 預處理器符號。 `-i` 同時也分析系統包含文件。 `-I` `_directory_` 聲明一個附加的包含路徑。用于尋找通過`EXEC SQL INCLUDE`包含的文件。 缺省是：`.`(當前目錄)、`/usr/local/include`、 在編譯時定義的PostgreSQL包含路徑(缺省為： `/usr/local/pgsql/include`)、`/usr/include`。順序同上。 `-o` `_filename_` 指定`ecpg`應該把它的所有輸出寫到給出的`_filename_`里。 `-r` `_option_` 選擇一個運行時行為。`_Option_`可以是下列的： `no_indicator` 不使用指示器，但是使用特殊的值來表示空值。歷史上有過數據庫使用這種方法。 `prepare` 使用它們之前預備所有語句。Libecpg將保存一個預備語句的緩沖，并且如果再次執行就重復使用一個語句。 如果緩存運行滿了，Libecpg將釋放最近使用的語句。 `questionmarks` 允許問號標識為了兼容原因作為占位符。很久以前這是缺省。 `-t` 打開自動提交模式。在這種模式下，每個查詢都自動提交，除非它是包圍在一個明確的事務塊中。 在缺省模式下，命令只是在發出`EXEC SQL COMMIT`的時候提交。 `-v` 打印額外的信息，包括版本和"include"路徑。 `--version` 打印ecpg版本然后退出。 `-?``--help` 顯示關于ecpg命令行參數的幫助，然后退出。 ## 注意 在編譯預處理的 C 代碼文件的時候，編譯器需要能夠找到PostgreSQL 包含目錄里面的ECPG頭文件。因此，在調用編譯器的時候可能需要使用 `-I`選項(比如`-I/usr/local/pgsql/include`)。 使用了嵌入 SQL 的 C 代碼必須和`libecpg`庫鏈接，比如， 使用這樣的鏈接選項：`-L/usr/local/pgsql/lib -lecpg`。 這些目錄的實際值可以通過[pg_config](#calibre_link-438)找到。 ## 例子 如果你有一個叫`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 ```