mSQL 数据库函数库

mSQL 是个小巧的数据库系统，可以到 http://www.hughes.com.au取得更多有关 mSQL 数据库的详情。

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++;
}
?>

原文转自：http://www.ltesting.net