PHP4手册:函数库及函数(八) DBA 函式库

-------------------------------------------------------------------------------- dba 函式库 -------------------------------------------------------------------------------- 本函式库公有 12 个函式在柏克莱的 bsd 系列功课体例中，有个大略的材料库构造，它以数个档案构成超袖珍的材料库体例，架形成笼统层 (abstraction layer) 的 dba 材料库。暂时 php 救济的 dba 材料库囊括 dbm：柏克莱兴盛的最早期 dba 材料库。 ndbm：较新且较有弹性的 dba。 gdbm：gnu 兴盛的 dba，ftp://ftp.gnu.org/pub/gnu/gdbm/ db2：由 sleepycat 软体开拓的 db2 (非 ibm 的 db2)，http://www.sleepycat.com cdb：这是 qmail 作家开拓赶快真实的 dba，http://pobox.com/~djb/cdb.html 以次是大略的运用典型，固然在运用前，必需先装好 dba。$id = dba_open("/tmp/test.db", "n", "db2");if(!$id) {    echo "dba_open failed\n";    exit;}dba_replace("key", "this is an example!", $id);if(dba_exists("key", $id)) {    echo dba_fetch("key", $id);    dba_delete("key", $id);}dba_close($id);?> dba_close: 封闭材料库。 dba_delete: 简略指定材料。 dba_exists: 查看键能否生存。 dba_fetch: 取回指定材料。 dba_firstkey: 取回顾笔键值。 dba_insert: 介入材料。 dba_nextkey: 取回下笔键值。 dba_popen: 打开并维持材料库连结。 dba_open: 打开材料库连结。 dba_optimize: 最好化材料库。 dba_replace: 变动或介入材料。 dba_sync: 材料库同步化。 -------------------------------------------------------------------------------- 函式:dba_close() -------------------------------------------------------------------------------- dba 函式库dba_close封闭材料库。语法: void dba_close(int handle);传回值: 无函式品种: 材料库功效  实质证明 本函式用来将已打开的材料库封闭。参数 handle 为打开材料库时所传回顾的代号 id。  参考 dba_popen()  dba_open()  -------------------------------------------------------------------------------- 函式:dba_delete() -------------------------------------------------------------------------------- dba 函式库dba_delete简略指定材料。语法: int dba_delete(string key, int handle);传回值: 平头函式品种: 材料库功效  实质证明 本函式将简略指定的材料。参数 key 为欲简略的键值 (key)。参数 handle 为打开材料库时所传回顾的代号 id。简略胜利则传回 true 值。  参考 dba_exists()  dba_fetch()  dba_insert()  dba_replace()  -------------------------------------------------------------------------------- 函式:dba_exists() -------------------------------------------------------------------------------- dba 函式库dba_exists查看键能否生存。语法: boolean dba_exists(string key, int handle);传回值: 布林值函式品种: 材料库功效  实质证明 本函式用来查看指定的键能否生存。参数 key 为待查看的键值 (key)。参数 handle 为打开材料库时所传回顾的代号 id。若键生存则传回 true 值。  参考 dba_delete()  dba_fetch()  dba_insert()  dba_replace()  -------------------------------------------------------------------------------- 函式:dba_fetch() -------------------------------------------------------------------------------- dba 函式库dba_fetch取回指定材料。语法: string dba_fetch(string key, int handle);传回值: 字串函式品种: 材料库功效  实质证明 本函式博得指定的材料。参数 key 为欲掏出材料的键值 (key)。参数 handle 为打开材料库时所传回顾的代号 id。传回值即为材料字串，若掏出波折则传回 false。  参考 dba_exists()  dba_delete()  dba_insert()  dba_replace()  -------------------------------------------------------------------------------- 函式:dba_firstkey() -------------------------------------------------------------------------------- dba 函式库dba_firstkey取回顾笔键值。语法: string dba_firstkey(int handle);传回值: 字串函式品种: 材料库功效  实质证明 本函式博得材料库的第一笔键值 (key)。参数 handle 为打开材料库时所传回顾的代号 id。传回值即为键值，若掏出波折则传回 false。  参考 dba_nextkey()  -------------------------------------------------------------------------------- 函式:dba_insert() -------------------------------------------------------------------------------- dba 函式库dba_insert介入材料。语法: boolean dba_insert(string key, string value, int handle);传回值: 布林值函式品种: 材料库功效  实质证明 本函式将介入材料至材料库中。参数 key 为键值 (key) 字串。参数 value 为欲介入的材料实质。参数 handle 为打开材料库时所传回顾的代号 id。胜利则传回 true 值。  参考 dba_exists()  dba_fetch()  dba_delete()  dba_replace()  -------------------------------------------------------------------------------- 函式:dba_nextkey() -------------------------------------------------------------------------------- dba 函式库dba_nextkey取回下笔键值。语法: string dba_nextkey(int handle);传回值: 字串函式品种: 材料库功效  实质证明 本函式博得材料库的下一笔键值 (key)。参数 handle 为打开材料库时所传回顾的代号 id。传回值即为键值，若掏出波折则传回 false。  参考 dba_firstkey()  -------------------------------------------------------------------------------- 函式:dba_popen() -------------------------------------------------------------------------------- dba 函式库dba_popen打开并维持材料库连结。语法: int dba_popen(string path, string mode, string handler);传回值: 平头函式品种: 材料库功效  实质证明 本函式用来打开指定的材料库，并维持与材料库连线的状况。参数 path 为材料库的路途及材料库称呼，比方 "/tmp/mysite/wahaha.db"。参数 mode 值如次表属性 证明 r 打开唯读既有材料库 w 打开可读写既有材料库 c 打开可读写材料库，若不生存则创造 n 删去现有材料库，若不生存则创造，之后可读写 参数 handler 为打开材料库的品种，有 dbm、ndbm、gdbm、db2 或 cdb 等品种。传回值为材料库的代号 id，若波折则传回 false。  参考 dba_close()  dba_open()  -------------------------------------------------------------------------------- 函式:dba_open() -------------------------------------------------------------------------------- dba 函式库dba_open打开材料库连结。语法: int dba_open(string path, string mode, string handler);传回值: 平头函式品种: 材料库功效  实质证明 本函式用来打开指定的材料库。参数 path 为材料库的路途及材料库称呼，比方 "/tmp/mysite/wahaha.db"。参数 mode 值如次表属性 证明 r 打开唯读既有材料库 w 打开可读写既有材料库 c 打开可读写材料库，若不生存则创造 n 删去现有材料库，若不生存则创造，之后可读写 参数 handler 为打开材料库的品种，有 dbm、ndbm、gdbm、db2 或 cdb 等品种。传回值为材料库的代号 id，若波折则传回 false。本函式和 dba_popen() 各别的场合在乎本函式打开的材料库在 php 程式中断后即封闭，dba_popen() 会维持与材料库连线，待下次再实行，则不用再翻开与材料库的连结。  参考 dba_close()  dba_popen()  -------------------------------------------------------------------------------- 函式:dba_optimize() -------------------------------------------------------------------------------- dba 函式库dba_optimize最好化材料库。语法: boolean dba_optimize(int handle);传回值: 布林值函式品种: 材料库功效  实质证明 本函式将材料库最好化。参数 handle 为打开材料库时所传回顾的代号 id。最好化胜利则传回 true 值，反之则传回 false。  参考 dba_sync()  -------------------------------------------------------------------------------- 函式:dba_replace() -------------------------------------------------------------------------------- dba 函式库dba_replace变动或介入材料。语法: boolean dba_replace(string key, string value, int handle);传回值: 布林值函式品种: 材料库功效  实质证明 本函式变动材料库中的材料，若材料不生存则介入。参数 key 为键值 (key) 字串。参数 value 为欲变动的材料实质。参数 handle 为打开材料库时所传回顾的代号 id。胜利则传回 true 值。  参考 dba_exists()  dba_fetch()  dba_delete()  dba_insert()  -------------------------------------------------------------------------------- 函式:dba_sync() -------------------------------------------------------------------------------- dba 函式库dba_sync材料库同步化。语法: boolean dba_sync(int handle);传回值: 布林值函式品种: 材料库功效  实质证明 本函式使体例在革新材料库时，能同声写入实业的材料库积聚安装 (如硬碟) 之中。参数 handle 为打开材料库时所传回顾的代号 id。同步胜利则传回 true 值，反之则传回 false。  参考 dba_optimize()