自由手記

msql: 送出 query 字符串。 
msql_affected_rows: 得到 mSQL 最後操作影響的列數目。 
msql_close: 關閉 mSQL 數據庫連接。 
msql_connect: 打開 mSQL 數據庫連接。 
msql_create_db: 建立一個新的 mSQL 數據庫。 
msql_createdb: 建立一個新的 mSQL 數據庫。 
msql_data_seek: 移動內部返回指針。 
msql_dbname: 取得目前所在數據庫名稱。 
msql_drop_db: 刪除指定的 mSQL 數據庫。 
msql_dropdb: 刪除指定的 mSQL 數據庫。 
msql_error: 取得最後錯誤信息。 
msql_fetch_array: 返回數組資料。 
msql_fetch_field: 取得字段信息。 
msql_fetch_object: 返回類資料。 
msql_fetch_row: 返回單列的各字段。 
msql_fieldname: 返回指定字段的名稱。 
msql_field_seek: 配置指針到返回值的某字段。 
msql_fieldtable: 獲得字段的資料表 (table) 名稱。 
msql_fieldtype: 獲得字段的類型。 
msql_fieldflags: 獲得字段的標誌。 
msql_fieldlen: 獲得字段的長度。 
msql_free_result: 釋放返回佔用內存。 
msql_freeresult: 釋放返回佔用內存。 
msql_list_fields: 列出指定資料表的字段 (field)。 
msql_listfields: 列出指定資料表的字段 (field)。 
msql_list_dbs: 列出可用數據庫 (database)。 
msql_listdbs: 列出可用數據庫 (database)。 
msql_list_tables: 列出指定數據庫的資料表 (table)。 
msql_listtables: 列出指定數據庫的資料表 (table)。 
msql_num_fields: 取得返回字段的數目。 
msql_num_rows: 取得返回列的數目。 
msql_numfields: 取得返回字段的數目。 
msql_numrows: 取得返回列的數目。 
msql_pconnect: 打開 mSQL 服務器持續連接。 
msql_query: 送出一個 query 字符串。 
msql_regcase: 將字符串逐字返回大小寫字符。 
msql_result: 取得查詢 (query) 的結果。 
msql_select_db: 選擇一個數據庫。 
msql_selectdb: 選擇一個數據庫。 
msql_tablename: 返回指定資料表的名稱。

msql
送出 query 字符串。
語法: int msql(string database, string query, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可送出 query 字符串到指定的 database 之中，在舊版的 PHP 程序，本函數為 msql_db_query()。參數 database 為資料載 (database) 的名稱。參數 query 為欲對數據庫下的指令字符串。參數 link_identifier 可省略，為數據庫連接的代號。執行正常則返回數據庫存取代號，發生錯誤則返回 false 值。
參考: msql_query()

msql_affected_rows
得到 mSQL 最後操作影響的列數目。
語法: int msql_affected_rows(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數取得 mSQL 在最後查詢操作 query 指令後所影響的列 (row) 數目，例如使用 UPDATE、DELETE 等指令。參數 query_identifier 為使用 msql_query() 或 msql() 時所打開的數據庫存取代號值。
參考: msql() msql_query()

msql_close
關閉 mSQL 數據庫連接。
語法: boolean msql_close(int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數關閉與 mSQL 數據庫服務器的連接。若無指定參數 link_identifier 則會關閉最後的一筆連接。用 msql_pconnect() 連接則無法使用本函數關閉。實際上本函數不是一定需要的，當 PHP 整頁程序結束後，將會自動關閉與數據庫的非永久性 (non-persistent) 連接。成功返回 true、失敗返回 false 值。
參考: msql_connect() msql_pconnect()

msql_connect
打開 mSQL 數據庫連接。
語法: int msql_connect(string [hostname[:port]], string [username], string [password]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數建立與 mSQL 服務器的連接。其中所有的參數都可省略。當使用本函數卻不加任何參數時，參數 hostname 的默認值為 localhost。而參數 hostname 後面可以加冒號與埠號，代表使用那個埠與 mSQL 連接。當然在使用數據庫時，早點使用 msql_close() 將連接關掉可以節省資源。
參考: msql_close() msql_pconnect()

msql_create_db
建立一個新的 mSQL 數據庫。
語法: boolean msql_create_db(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數用來建立新的數據庫 (database)。在建立前，必須先與服務器連接。若無使用參數 link_identifier，則使用最後的連接代號。
參考: msql_drop_db()

msql_createdb
建立一個新的 mSQL 數據庫。
語法: boolean msql_createdb(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數用來建立新的數據庫 (database)，這個函數其實也就是 msql_create_db()。
參考 msql_drop_db()

msql_data_seek
移動內部返回指針。
語法: boolean msql_data_seek(int query_identifier, int row_number);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數可移動內部返回的列指針到指定的 row_number 去。之後若使用 msql_fetch_row() 可以返回新列的值。參數 query_identifier 為指令 (query) 代號。成功返回 true、失敗則返回 false。
參考: msql_fetch_row()

msql_dbname
取得目前所在數據庫名稱。
語法: string msql_dbname(int query_identifier, int i);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數用來取得目前所在的數據庫 (database) 名稱。參數 query_identifier 為指令 (query) 代號。參數 i 為使用 msql_listdbs() 所返回的數據庫指針。本函數返回值為數據庫名稱字符串。

msql_drop_db
刪除指定的 mSQL 數據庫。
語法: boolean msql_drop_db(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數用來刪除指定的數據庫 (database)。在刪除前，注意須與服務器連接。參數 database_name 為欲刪除的數據庫名稱。若無使用參數 link_identifier，則使用最後的連接代號。刪除成功則返回 true，失敗則返回 false。
參考: msql_create_db()

msql_dropdb
刪除指定的 mSQL 數據庫。
語法: boolean msql_dropdb(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數用來刪除指定的數據庫 (database)，這個函數和 msql_drop_db() 是完全相同的。在刪除前，注意須與服務器連接。參數 database_name為欲刪除的數據庫名稱。若無使用參數 link_identifier，則使用最後的連接代號。刪除成功則返回 true，失敗則返回 false。
參考: msql_drop_db() msql_create_db()

msql_error
取得最後錯誤信息。
語法: string msql_error(int [link_identifier]);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數用來取得 mSQL 數據庫的最後錯誤信息字符串。若無使用參數 link_identifier，則使用最後的連接代號。

msql_fetch_array
返回數組資料。
語法: array msql_fetch_array(int query_identifier);
返回值: 數組
函數種類: 數據庫功能
內容說明: 本函數用來將查詢結果分割到數組變量中。可以將本函數當作是 msql_fetch_row() 的加強版。
使用範例 
<?php
echo "<ol type=A>\n";
$handle = msql_connect("localhost");
msql_selectdb("userinfo", $handle);
$dbresult=msql_query("select * from info", $handle);
while($dbarray=msql_fetch_array($dbresult)) {
echo "<li>".$dbarray["IDNumber"]."\n";
}
msql_close($handle);
echo "</ol>\n";
?>

msql_fetch_field
取得字段信息。
語法: object msql_fetch_field(int query_identifier, int [field_offset]);
返回值: 類
函數種類: 數據庫功能
內容說明: 本函數返回的類資料為 query_identifier 的字段 (Column) 信息。返回類的屬性如下： 
name - 字段名稱 
table - 字段所在表格的資料表名稱 
not_null - 若為 1 表示本字段不能是空的 (null) 
primary_key - 若為 1 表示本字段是主要鍵 (primary key) 
unique_key - 若為 1 表示本字段為不可重覆鍵 (unique key) 
type - 字段類型 
參考: msql_field_seek()

msql_fetch_object
返回類資料。
語法: object msql_fetch_object(int query_identifier);
返回值: 類
函數種類: 數據庫功能
內容說明: 本函數用來將查詢結果 query_identifier 拆到類變量中。使用方法和 msql_fetch_array() 幾乎相同，不同的地方在於本函數返回資料是類而不是數組。若 query_identifier 沒有資料，則返回 false 值。另外治募注意的地方是，取回的類資料的索引只能是文字而不能用數字，這是因為類的特性。類資料的特性中所有的屬性 (property) 名稱都不能是數字。關於速度方面，本函數的處理速度幾乎和 msql_fetch_array()、msql_fetch_row() 二函數差不多，要用哪個函數還是看使用的需求決定。
參考: msql_fetch_array() msql_fetch_row()

msql_fetch_row
返回單列的各字段。
語法: array msql_fetch_row(int query_identifier);
返回值: 數組
函數種類: 數據庫功能
內容說明: 本函數用來將查詢結果 query_identifier 之單列拆到數組變量中。數組的索引是數字索引，第一個的索引值是 0。若 query_identifier 沒有資料，則返回 false 值。
參考: msql_fetch_array() msql_fetch_object() msql_data_seek() msql_result()

msql_fieldname
返回指定字段的名稱。
語法: string msql_fieldname(int query_identifier, int field);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數用來取得指定字段的名稱。參數 query_identifier 為查詢結果的 ID 代碼。參數 field 為第幾個字段的數字。

msql_field_seek
配置指針到返回治募某字段。
語法: int msql_field_seek(int query_identifier, int field_offset);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數配置目前的指針到返回治募特定字段中。參數 query_identifier 為查詢結果的 ID 代碼。參數 field_offset 為第幾個字段。
參考: msql_fetch_field()

msql_fieldtable
獲得字段的資料表 (table) 名稱。
語法: int msql_fieldtable(int query_identifier, int field);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數可以得到目前所在字段的資料表名。

msql_fieldtype
獲得字段的類型。
語法: string msql_fieldtype(int query_identifier, int field);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數可以得到目前所在字段的類型格式。參數 query_identifier 為查詢結果的 ID 代碼。參數 field 為第幾個字段的數字。返回的字符串為字段的類型，包括了 int、string、real 等三種類型。

msql_fieldflags
獲得字段的標誌。
語法: string msql_fieldflags(int query_identifier, int field);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數可以得到目前所在字段的標誌。參數 query_identifier 為查詢結果的 ID 代碼。參數 field 為第幾個字段的數字。返回的標誌字符串可能是：not null、primary key 或二者都有或者是空字符串 (表 null)。

msql_fieldlen
獲得字段的長度。
語法: int msql_fieldlen(int query_identifier, int field);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到目前所在字段的長度。參數 query_identifier 為查詢結果的 ID 代碼。參數 field 為第幾個字段的數字。

msql_free_result
釋放返回佔用內存。
語法: int msql_free_result(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以釋放目前 mSQL 數據庫 query 所佔用的內存。一般只有在非常擔心在內存的使用上可能會不足的情形下才會用本函數。PHP 程序會在結束時自動釋放內存。

msql_freeresult
釋放返回佔用內存。
語法: int msql_freeresult(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以釋放目前 mSQL 數據庫 query 所佔用的內存。一般只有在非常擔心在內存的使用上可能會不足的情形下才會用本函數。本函數和 msql_free_result() 一樣。

msql_list_fields
列出指定資料表的字段 (field)。
語法: int msql_list_fields(string database, string tablename, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到指定的資料表的所有字段。參數 database 為數據庫名稱。參數 tablename 為資料表名稱。參數 link_identifier 可省略，為連接的代碼。返回的字段信息可以供 msql_fieldflags()、msql_fieldlen()、msql_fieldname() 和 msql_fieldtype() 等函數使用。若有錯誤則返回 -1。

msql_listfields
列出指定資料表的字段 (field)。
語法: int msql_listfields(string database, string tablename, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到指定的資料表的所有字段。參數 database 為數據庫名稱。參數 tablename 為資料表名稱。參數 link_identifier 可省略，為連接的代碼。返回的字段信息可以供 msql_fieldflags()、msql_fieldlen()、msql_fieldname() 和 msql_fieldtype() 等函數使用。若有錯誤則返回 -1。本函數和 msql_list_fields() 相同。

msql_list_dbs
列出可用數據庫 (database)。
語法: int msql_list_dbs(int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到 mSQL 服務器的可用數據庫。參數 link_identifier 可省略。

msql_listdbs
列出可用數據庫 (database)。
語法: int msql_listdbs(int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到 mSQL 服務器的可用數據庫。參數 link_identifier 可省略。本函數和 msql_list_dbs() 相同。

msql_list_tables
列出指定數據庫的資料表 (table)。
語法: int msql_list_tables(string database, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到指定數據庫中的所有資料表名稱。參數 database 為指定的數據庫名稱。參數 link_identifier 可省略。

msql_listtables
列出指定數據庫的資料表 (table)。
語法: int msql_listtables(string database, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到指定數據庫中的所有資料表名稱。參數 database 為指定的數據庫名稱。參數 link_identifier 可省略。本函數和 msql_list_tables() 相同。

msql_num_fields
取得返回字段的數目。
語法: int msql_num_fields(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到返回字段的數目。參數 query_identifier 為查詢的代號。
參考: msql() msql_query() msql_fetch_field() msql_num_rows()

msql_num_rows
取得返回列的數目。
語法: int msql_num_rows(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到返回列的數目。參數 query_identifier 為查詢的代號。

msql_numfields
取得返回字段的數目。
語法: int msql_numfields(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到返回字段的數目。參數 query_identifier 為查詢的代號。本函數和 msql_num_fields() 相同。
參考: msql() msql_query() msql_num_fields() msql_fetch_field() msql_num_rows()

msql_numrows
取得返回列的數目。
語法: int msql_numrows(int query_identifier);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數可以得到返回列的數目。參數 query_identifier 為查詢的代號。本函數和 msql_num_rows() 相同。

msql_pconnect
打開 mSQL 服務器持續連接。
語法: int msql_pconnect(string [hostname[:port]] , string [username] , string [password]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數和 msql_connect() 用法及參數均雷同。不同的處在於使用本函數打開數據庫時，程序會先尋找是否曾經執行過本函數，若執行過則返回先前執行的 ID。另一個不同的地方是本函數無法使用 msql_close() 關閉數據庫。

msql_query
送出一個 query 字符串。
語法: int msql_query(string query, int [link_identifier]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數送出 query 字符串供 mSQL 做相關的處理或者執行。參數 query 為合乎 SQL 語法的 query 字符串。若沒有指定 link_identifier 參數，則程序會自動尋找最近打開的 ID。
參考: msql() msql_select_db() msql_connect()

msql_regcase
將字符串逐字返回大小寫字符。
語法: string msql_regcase(string string);
返回值: 數組
函數種類: 數據庫功能
內容說明: 本函數可將字符串之字符逐字返回大小寫。在 PHP 使用上，本函數沒有什麼作用，但可能可以提供外部程序或數據庫處理。本函數即 sql_regcase()。

msql_result
取得查詢 (query) 的結果。
語法: int msql_result(int query_identifier, int row, mixed [field]);
返回值: 整數
函數種類: 數據庫功能
內容說明: 本函數取得一格 query 的結果。參數 field 可以是字段名稱、順序或者是 fieldname.tablename 的格式。在返回資料量少時，可以使用本函數來處理。當數據庫大時，本函數的效率就有待考量了，這時可以使用較有效率的 msql_fetch_row()、msql_fetch_array() 或 msql_fetch_object() 等函數。

msql_select_db
選擇一個數據庫。
語法: boolean msql_select_db(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數選擇 mSQL 服務器中的數據庫以供之後的資料查詢作業 (query) 處理。成功返回 true，失敗則返回 false。
參考: msql_connect() msql_pconnect() msql_query()

msql_selectdb
選擇一個數據庫。
語法: boolean msql_selectdb(string database_name, int [link_identifier]);
返回值: 布爾值
函數種類: 數據庫功能
內容說明: 本函數選擇 mSQL 服務器中的數據庫以供之後的資料查詢作業 (query) 處理。成功返回 true，失敗則返回 false。本函數即 msql_select_db()。
參考: msql_connect() msql_pconnect() msql_query()

msql_tablename
返回指定資料表的名稱。
語法: string msql_tablename(int query_identifier, int field);
返回值: 字符串
函數種類: 數據庫功能
內容說明: 本函數用來取得資料表字段的名稱。參數 query_identifier 為查詢結果的 ID 代碼。參數 field 為第幾個字段的數字。
使用範例 
<?php 
msql_connect ("localhost");
$result = msql_list_tables("userinfo");
$i = 0;
while ($i < msql_numrows($result)) {
$tb_names[$i] = msql_tablename($result, $i);
echo $tb_names[$i] . "<br>\n";
$i++; 
}
?>