; MySQL提供用C編程語言編寫的客戶機庫，可以用它編寫訪問MySQL的客戶機程序。這個庫定義了應用程序編程接口，包括下面的實用程序： ; ■ 建立和終止與服務器會話的連接管理例程。 ; ■ 構造查詢的例程，將例程發送到服務器，并處理結果。 ; ■ 當其他C API調用失敗時，確定錯誤準確原因的狀態和錯誤報告函數。 ; 本章介紹如何用客戶機庫編寫自己的程序。我們要記住的一些要點是，自己的程序與MySQL分發包中已有的客戶機程序的一致性，代碼的模塊性和可重用性。本章假設您知道用C編程的一些知識，但并不一定是專家。本章從簡單到復雜粗略地開發了一系列的客戶機程序。這個過程是第一部分開發了一個程序框架，該框架除了與服務器連接和斷開以外不能作任何事情。這樣做的原因是，盡管MySQL客戶機程序是為不同的目的而編寫的，但它們都有一個共同點：即創建與服務器的連接。 ; 我們將用以下步驟來建立這個程序框架： ; 1. 編寫一些連接和斷開的簡要代碼（客戶機程序1）。 ; 2. 增加一些錯誤檢查（客戶機程序2）。 ; 3. 使連接代碼模塊化和可重用化（客戶機程序3）。 ; 4. 增加獲取運行時連接參數的能力（主機，用戶，口令）（客戶機程序4）。 ; 這個框架一般是合理的，可以使用它作為編寫任意數量的客戶機程序的基礎。開發它以后，我們將暫不考慮如何處理各種問題。首先，我們將討論如何處理特定的硬編碼的SQL語句，然后再開發用于處理任意語句的代碼。在這之后，將查詢處理的代碼增加到客戶機程序框架中，開發另一個程序（客戶機程序5），它類似于mysql客戶機程序。我們也將考慮（并解決）一些通用的問題，如“如何獲取有關表的結構信息？”和“如何在數據庫中插入圖像？”只有在需要時，本章才討論客戶機庫的函數和數據類型。要想了解所有函數和類型的列表，請參閱附錄F“C API 參考”?？梢杂眠@個附錄作為使用客戶機庫任何部分的進一步的背景信息的參考。 ; 樣例程序可以由聯機下載得到，可以直接使用，而不必再鍵入它們。有關的指導，請參閱附錄A“獲得和安裝軟件”。 ; 在哪里尋找樣例 ; MySQL郵件清單的一個共同問題就是“我在哪里可以找到一些用C 寫的客戶機樣例？”。當然，這個答案是“就在本書里！”。但是，許多人好像并沒有考慮的是MySQL分發包中包括了若干客戶機程序（例如mysql、mysqladmin 和mysqldump），這些大部分都是用C編寫的。因為這個分發包可以很容易地以源程序形式使用，所以MySQL提供非常少的樣例客戶機代碼。因此，如果您還沒有這樣做，找個時間找到源程序分發包，在客戶機目錄中查看這些程序。MySQL客戶機程序為共享軟件，從那里可以為自己的程序自由地借用代碼。 ; 在本章提供的樣例和MySQL分發包中包括的客戶機程序之間，可以找到與自己編寫程序時想做的事情相類似的代碼。如果是這樣，可以通過拷貝和修改已有的程序來重新使用代碼。應該閱讀本章，了解客戶機庫是如何工作的。然而，請記住，并不總是需要自己編寫瑣碎的每件事情（您將注意到，在本章編寫程序的討論中，代碼的可重用性是目的之一）。通過使用其他人編好的程序，可以避免許多工作，那是最好的。 ; 6.1建立客戶機程序的一般過程 ; 本節介紹使用MySQL客戶機庫編譯和連接程序所包括的步驟。不同的系統建立客戶機程序的命令也有所不同，可能需要稍微修改一下這里介紹的命令。然而，這里的說明是通用的，應該能夠將它用于幾乎您編寫的任何客戶機程序中。 ; 6.1.1基本的系統需求 ; 當您用C 編寫MySQL客戶程序時，顯然將需要一個C 編譯程序。這里說明的樣例使用gcc。除了自己的源文件以外，還將需要下列程序： ; ■ MySQL頭文件。 ; ■ MySQL客戶機庫。 ; MySQL頭文件和客戶機庫組成客戶機編程的支持程序。它們可能已經安裝到您的系統上。如果沒有，應獲取它們。如果MySQL從源程序分發包或二進制分發包中安裝，則客戶機可編程的支持程序應該已經作為該處理的一部分安裝了。如果MySQL是從RPM 文件中安裝的，則除非安裝了開發程序R P M，否則就沒有這種支持。如果需要安裝MySQL頭文件和庫，請參閱附錄A。 ; 6.1.2 編譯和連接客戶機程序 ; 要想編譯和連接客戶機程序，就必須指定MySQL頭文件和客戶機庫的位置，因為它們通常不安裝在編譯程序和連接程序缺省搜索的位置。對于下面的樣例，假定頭文件和客戶機庫的位置為/usr/local/include/mysql和/ usr / local / lib / mysql。要想告知編譯程序如何尋找MySQL頭文件，則當將源文件編譯為目標文件時，傳送給它一個-I/usr/local/include/mysql參數。例如，可以使用這樣的命令： 要想告知連接程序在哪，可以找到客戶機庫和它的名稱，當連接目標文件產生一個可執行的二進制文件時，傳送-L/usr/local/lib/mysql和-lmysqlclient 參數，如下所示： 如果客戶機程序包括多個文件，則所有目標文件的名稱都要列在連接命令上。如果連接步驟導致不能找到必需的floor() 函數的錯誤，則通過在命令行的后面增加- l m，連接到數學庫： 可能還需要增加其他的庫。例如，在Solaris 上可能需要-lsocket -lnsl。 ; 如果沒有使用make 建立程序，則建議您了解一下如何進行，以便不必手工地鍵入許多建立程序的命令。假設有一個客戶機程序myclient，包括兩個源文件main.c 和aux.c，及一個頭文件myclient.h。一個簡單的Makefile 建立這個程序的代碼，如下所示： 如果是一個需要連接到數學庫的系統，則更改LIBS 的值，并將-lm 加到最后：LIBS = -L/usr/local/lib/mysql-lmysqlclient -lm如果需要其他的庫，如-lsocket 和- l n s l，則也要將這些庫加到LIBS 中。使用M a k e f i l e，無論何時修改何源文件，只簡單地鍵入“ m a k e”就可以重新建立程序代碼。那比鍵入一句長的gcc 命令更容易，發生錯誤更少。