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 材料库函式馆的关系资源讯息。本函式不需输出参数，传回值为资源讯息字串。