From 9904027e99921abf89834775b5ee842b95494171 Mon Sep 17 00:00:00 2001 From: Egon Schmid Date: Sat, 9 Sep 2000 01:06:51 +0000 Subject: [PATCH] Looks now more like XML. git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@32297 c90b9560-bf6c-de11-be94-00142212c4b1 --- functions/dba.xml | 159 +++++++++++++++++++++------------------------- 1 file changed, 72 insertions(+), 87 deletions(-) diff --git a/functions/dba.xml b/functions/dba.xml index 8f865e0e1f..d180bc9b2c 100644 --- a/functions/dba.xml +++ b/functions/dba.xml @@ -21,8 +21,8 @@ database and will do nothing for others. - To add support for any of the following handlers, add the specified --with - configure switch to your PHP configure line: + To add support for any of the following handlers, add the + specified --with configure switch to your PHP configure line: @@ -333,35 +333,33 @@ for ($i = 0; $i < count($handle_later); $i++) int handle - dba_insert inserts the entry described with key and value into the database specified by handle. It fails, if an entry - with the same key already exists. - + with the same key already exists. + - key is the key of the entry to be inserted. - + key is the key of the entry to be inserted. + - value is the value to be inserted. - + value is the value to be inserted. + handle is a database handle returned by - dba_open. - + dba_open. + dba_insert returns true or false, depending on - whether it succeeds of fails, respectively. - + whether it succeeds of fails, respectively. + See also: dba_exists dba_delete dba_fetch dba_replace - - + @@ -378,25 +376,23 @@ for ($i = 0; $i < count($handle_later); $i++) int handle - dba_nextkey returns the next key of the database specified by handle and increments the internal - key pointer. - + key pointer. + handle is a database handle returned by - dba_open. - + dba_open. + dba_nextkey returns the key or false depending on - whether it succeeds or fails, respectively. - + whether it succeeds or fails, respectively. + See also: dba_firstkey - - + @@ -420,33 +416,32 @@ for ($i = 0; $i < count($handle_later); $i++) dba_popen establishes a persistent database instance for path with mode using - handler. - + handler. + - path is commonly a regular path in your filesystem. - + path is commonly a regular path in your filesystem. + mode is "r" for read access, "w" for read/write access to an already existing database, "c" for read/write access and database creation if it doesn't currently exist, and "n" for - create, truncate and read/write access. - + create, truncate and read/write access. + handler is the name of the handler which shall be used for accessing path. It is passed all optional parameters given to dba_popen and can act on behalf - of them. - + of them. + dba_popen returns a positive handler id or false, in - the case the open is successful or fails, respectively. - + the case the open is successful or fails, respectively. + See also: dba_open dba_close - - + @@ -466,37 +461,35 @@ for ($i = 0; $i < count($handle_later); $i++) ... - dba_open establishes a database instance for path with mode using - handler. - + handler. + - path is commonly a regular path in your filesystem. - + path is commonly a regular path in your filesystem. + mode is "r" for read access, "w" for read/write access to an already existing database, "c" for read/write access and database creation if it doesn't currently exist, and "n" for - create, truncate and read/write access. - + create, truncate and read/write access. + handler is the name of the handler which shall be used for accessing path. It is passed all optional parameters given to dba_open and can act on behalf of - them. - + them. + dba_open returns a positive handler id or false, in - the case the open is successful or fails, respectively. - + the case the open is successful or fails, respectively. + See also: dba_popen dba_close - - + @@ -513,24 +506,22 @@ for ($i = 0; $i < count($handle_later); $i++) int handle - dba_optimize optimizes the underlying database - specified by handle. - + specified by handle. + handle is a database handle returned by - dba_open. - + dba_open. + dba_optimize returns true or false, if the - optimization succeeds or fails, respectively. - + optimization succeeds or fails, respectively. + See also: dba_sync - - + @@ -549,34 +540,30 @@ for ($i = 0; $i < count($handle_later); $i++) int handle - dba_replace replaces or inserts the entry described with key and value into the - database specified by handle. - + database specified by handle. + - key is the key of the entry to be inserted. - + key is the key of the entry to be inserted. + - value is the value to be inserted. - + value is the value to be inserted. + handle is a database handle returned by - dba_open. - + dba_open. + dba_replace returns true or false, depending on - whether it succeeds of fails, respectively. - + whether it succeeds of fails, respectively. + - See also: - dba_exists - dba_delete - dba_fetch - dba_insert - - + See also: dba_exists, + dba_delete, dba_fetch, + and dba_insert. + @@ -593,27 +580,25 @@ for ($i = 0; $i < count($handle_later); $i++) int handle - dba_sync synchronizes the database specified by handle. This will probably trigger a physical write - to disk, if supported. - + to disk, if supported. + handle is a database handle returned by - dba_open. - + dba_open. + dba_sync returns true or false, if the - synchronization succeeds or fails, respectively. - + synchronization succeeds or fails, respectively. + - See also: - dba_optimize - - + See also: dba_optimize + +