MySQL 数据库函数库(2)

使用范例

下面的例子示范如使用返回的类。

参考: mysql_fetch_array() mysql_fetch_row()

mysql_fetch_row

返回单列的各字段。

语法: array mysql_fetch_row(int result);

返回值: 数组

函数种类: 数据库功能

内容说明: 本函数用来将查询结果 result 之单列拆到数组变量中。数组的索引是数字索引，第一个的索引值是 0。若 result 没有资料，则返回 false 值。

参考: mysql_fetch_array() mysql_fetch_object() mysql_data_seek() mysql_fetch_lengths() mysql_result()

mysql_field_name

返回指定字段的名称。

语法: string mysql_field_name(int result, int field_index);

返回值: 字符串

函数种类: 数据库功能

内容说明: 本函数用来取得指定字段的名称。

使用范例

mysql_field_name($result,2);

mysql_field_seek

配置指针到返回治募?某字段。

语法: int mysql_field_seek(int result, int field_offset);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数配置目前的指针到返回治募?特定字段中。

参考: mysql_fetch_field()

mysql_field_table

获得目前字段的资料表 (table) 名称。

语法: string mysql_field_table(int result, int field_offset);

返回值: 字符串

函数种类: 数据库功能

内容说明: 本函数可以得到目前所在字段的资料表名。

mysql_field_type

获得目前字段的类型。

语法: string mysql_field_type(int result, int field_offset);

返回值: 字符串

函数种类: 数据库功能

内容说明: 本函数可以得到目前所在字段的类型格式。返回的字符串为字段的类型，包括了 int、real、string、blob....等等，详见 MySQL 的相关文件中有关于类型的部份。

使用范例

mysql_field_flags

获得目前字段的标志。

语法: string mysql_field_flags(int result, int field_offset);

返回值: 字符串

函数种类: 数据库功能

内容说明: 本函数可以得到目前所在字段的标志。若一个字段有数种属性标志，则返回的标志为这些属性连起来的字符串，每个属性都用空格隔开，可以使用 explode() 切开这些字符串。返回的标志可能是：not_null、primary_key、unique_key、multiple_key、blob、unsigned、zerofill、binary、enum、auto_increment、timestamp。

mysql_field_len

获得目前字段的长度。

语法: int mysql_field_len(int result, int field_offset);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到目前所在字段的长度。

mysql_free_result

释放返回占用内存。

语法: boolean mysql_free_result(int result);

返回值: 布尔值

函数种类: 数据库功能

内容说明: 本函数可以释放目前 MySQL 数据库 query 返回所占用的内存。一般只有在非常担心在内存的使用上可能会不足的情形下才会用本函数。PHP 程序会在结束时自动释放。

mysql_insert_id

返回最后一次使用 INSERT 指令的 ID。

语法: int mysql_insert_id(int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到最后一次使用 INSERT 到 MySQL 数据库的执行 ID。sleibowitz@btcwcu.org (13-May-1999) 指出在 PHP 3.0.7 版用 REPLACE 也和使用 INSERT 一样，可以使用本函数获得 ID。

mysql_list_fields

列出指定资料表的字段 (field)。

语法: int mysql_list_fields(string database_name, string table_name, int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到指定的资料表的所有字段。返回的字段信息可以供 mysql_field_flags()、mysql_field_len()、mysql_field_name() 及 mysql_field_type() 等函数使用。若有错误则返回 -1。

mysql_list_dbs

列出 MySQL 服务器可用的数据库 (database)。

语法: int mysql_list_dbs(int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到 MySQL 服务器的可用数据库。

mysql_list_tables

列出指定数据库的资料表 (table)。

语法: int mysql_list_tables(string database, int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到指定数据库中的所有资料表名称。

mysql_num_fields

取得返回字段的数目。

语法: int mysql_num_fields(int result);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到返回字段的数目。

参考: mysql_db_query() mysql_query() mysql_fetch_field() mysql_num_rows()

mysql_num_rows

取得返回列的数目。

语法: int mysql_num_rows(int result);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数可以得到返回列的数目。

参考: mysql_db_query() mysql_query() mysql_fetch_row()

mysql_pconnect

打开 MySQL 服务器持续连接。

语法: int mysql_pconnect(string [hostname] [:port], string [username], string [password]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数和 mysql_connect() 雷同。不同的地方在于使用本函数打开数据库时，程序会先寻找是否曾经执行过本函数，若执行过则返回先前执行的 ID。另一个不同的地方是本函数无法使用 mysql_close() 关闭数据库。

mysql_query

送出一个 query 字符串。

语法: int mysql_query(string query, int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数送出 query 字符串供 MySQL 做相关的处理或者执行。若没有指定 link_identifier 参数，则程序会自动寻找最近打开的 ID。当 query 查询字符串是 UPDATE、INSERT 及 DELETE 时，返回的可能是 true 或者 false；查询的字符串是 SELECT 则返回新的 ID 值。joey@samaritan.com (09-Feb-1999) 指出，当返回 false 时，并不是执行成功但无返回值，而是查询的字符串有错误。

参考: mysql_db_query() mysql_select_db() mysql_connect()

mysql_result

取得查询 (query) 的结果。

语法: int mysql_result(int result, int row, mixed field);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数取得一格 query 的结果。参数 field 可以是字段名称、顺序或者是 FieldName.TableName 的格式。在返回资料量少时，可以使用本函数来处理。当数据库大时，本函数的效率就有待考量了，这时可以使用较有效率的 mysql_fetch_row()、mysql_fetch_array() 及 mysql_fetch_object() 等函数。

mysql_select_db

选择一个数据库。

语法: int mysql_select_db(string database_name, int [link_identifier]);

返回值: 整数

函数种类: 数据库功能

内容说明: 本函数选择 MySQL 服务器中的数据库以供之后的资料查询作业 (query) 处理。成功返回 true，失败则返回 false。

参考: mysql_connect() mysql_pconnect() mysql_query()

mysql_tablename

取得资料表名称。

语法: string mysql_tablename(int result, int i);

返回值: 字符串

函数种类: 数据库功能

内容说明: 本函数可取得资料表名称字符串，一般配合 mysql_list_tables() 函数使用，取得该函返回的数字的名称字符串。

使用范例