PHP4手册:函数库及函数(十) dbm 类资料库函式库

--------------------------------------------------------------------------------
 dbm 类资料库函式库 
--------------------------------------------------------------------------------
 

本函式库共有 10 个函式
dbm 为柏克莱大学所发展的档案型资料库。欲使用本函式可能需要先安装相关的 DBM 函数馆，当然在 BSD 系列的作业系统中已经装好的就不用自行动手了。
dbm 在资料存取没有很复杂的栏位，它只有单纯的键/值 (key/value) 的栏位。

下例为简单的 dbm 使用范例

function do_stuff() {
  // 略去复杂的资料处理流程
}
$dbm = dbmopen("lastseen", "w");
if (dbmexists($dbm, $userid)) {
  $last_seen = dbmfetch($dbm, $userid);
} else {
  dbminsert($dbm, $userid, time());
}
do_stuff();
dbmreplace($dbm, $userid, time());
dbmclose($dbm);
?>

dbmopen: 开启 DBM 资料库连结。 
dbmclose: 关闭 DBM 资料库。 
dbmexists: 检查键是否存在。 
dbmfetch: 取回指定资料。 
dbminsert: 加入资料。 
dbmreplace: 更动或加入资料。 
dbmdelete: 删除指定资料。 
dbmfirstkey: 取回首笔键名。 
dbmnextkey: 取回下笔键值。 
dblist: 取得 DBM 的资讯。 

--------------------------------------------------------------------------------
 函式:dbmopen() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmopen
开启 DBM 资料库连结。

语法: int dbmopen(string filename, string flags);

传回值: 整数

函式种类: 资料库功能

 
 
内容说明 

本函式用来开启指定的资料库。参数 path 为资料库的路径加上资料库名称。参数 mode 值如下表

属性 说明 
r 开启唯读既有资料库 
w 开启可读写既有资料库 
c 开启可读写资料库，若不存在则建立 
n 删去现有资料库，若不存在则建立，之后可读写 

传回值为资料库的代号 ID，若失败则传回 false。 

--------------------------------------------------------------------------------
 函式:dbmclose() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmclose
关闭 DBM 资料库。

语法: boolean dbmclose(int handle);

传回值: 布林值

函式种类: 资料库功能

 
 
内容说明 

本函式用来将已开启的资料库关闭。参数 handle 为开启资料库时所传回来的代号 ID。

--------------------------------------------------------------------------------
 函式:dbmexists() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmexists
检查键是否存在。

语法: boolean dbmexists(int handle, string key);

传回值: 布林值

函式种类: 资料库功能

 
 
内容说明 

本函式用来检查指定的键是否存在。参数 handle 为开启资料库时所传回来的代号 ID。参数 key 为待检查的键值 (key)。若键存在则传回 true 值。

--------------------------------------------------------------------------------
 函式:dbmfetch() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmfetch
取回指定资料。

语法: string dbmfetch(int handle, string key);

传回值: 字串

函式种类: 资料库功能

 
 
内容说明 

本函式取得指定的资料。参数 handle 为开启资料库时所传回来的代号 ID。参数 key 为欲取出资料的键值 (key)。传回值即为资料字串，若取出失败则传回 false。

--------------------------------------------------------------------------------
 函式:dbminsert() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbminsert
加入资料。

语法: int dbminsert(int handle, string key, string value);

传回值: 整数

函式种类: 资料库功能

 
 
内容说明 

本函式将加入资料至资料库中。参数 handle 为开启资料库时所传回来的代号 ID。参数 key 为键值 (key) 字串。参数 value 为欲加入的资料内容。成功则传回 0；传回值 -1 表示该资料库档案为唯读的状态；传回值 1 则表示该键已经存在，可用 dbmreplace() 取代。

--------------------------------------------------------------------------------
 函式:dbmreplace() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmreplace
更动或加入资料。

语法: boolean dbmreplace(int handle, string key, string value);

传回值: 布林值

函式种类: 资料库功能

 
 
内容说明 

本函式更动资料库中的资料，若资料不存在则加入。参数 handle 为开启资料库时所传回来的代号 ID。参数 key 为键值 (key) 字串。参数 value 为欲更动的资料内容。成功则传回 true 值。

--------------------------------------------------------------------------------
 函式:dbmdelete() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmdelete
删除指定资料。

语法: boolean dbmdelete(int handle, string key);

传回值: 布林值

函式种类: 资料库功能

 
 
内容说明 

本函式将删除指定的资料。参数 handle 为开启资料库时所传回来的代号 ID。参数 key 为欲删除的键值 (key)。若该键值不存在无法删除则传回 false
 

--------------------------------------------------------------------------------
 函式:dbmfirstkey() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmfirstkey
取回首笔键名。

语法: string dbmfirstkey(int handle);

传回值: 字串

函式种类: 资料库功能

 
 
内容说明 

本函式取得资料库的第一笔键名 (key)。参数 handle 为开启资料库时所传回来的代号 ID。传回值即为键名，若取出失败则传回 false。值得注意的是资料库的资料没有任何排序的情形，无法预期传回的资料是依何方式排序后的第一笔资料。若需要特定顺序的第一笔资料，则需读回全部的资料到阵列中，再使用 PHP 的排序函式排序后方可取得所需值。

--------------------------------------------------------------------------------
 函式:dbmnextkey() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dbmnextkey
取回下笔键值。

语法: string dbmnextkey(int handle, string key);

传回值: 字串

函式种类: 资料库功能

 
 
内容说明 

本函式取得资料库的下一笔键值 (key)。参数 handle 为开启资料库时所传回来的代号 ID。传回值即为键值。

 
 
使用范例 

// 之前已经开启 DBM 资料库。
$key = dbmfirstkey($dbm_id);
while ($key) {
    echo "$key = " . dbmfetch($dbm_id, $key) . "\n";
    $key = dbmnextkey($dbm_id, $key);
}
?> 
 

--------------------------------------------------------------------------------
 函式:dblist() 
--------------------------------------------------------------------------------
 

dbm 类资料库函式库

dblist
取得 DBM 的资讯。

语法: string dblist(void);

传回值: 字串

函式种类: 资料库功能

 
 
内容说明 

本函式取得 DBM 资料库函式馆的相关资讯。本函式不需输入参数，传回值为资讯字串。