dba_fetch(3) [php man page]

DBA_FETCH(3)								 1							      DBA_FETCH(3)

dba_fetch - Fetch data specified by key

SYNOPSIS

       string dba_fetch (string  $key, resource  $handle)

DESCRIPTION

       string dba_fetch (string  $key, int  $skip, resource  $handle)

       dba_fetch(3) fetches the data specified by $key from the database specified with $handle.

PARAMETERS

	      o $key
		- The key the data is specified by.

	      Note

		      When  working  with  inifiles this function accepts arrays as keys where index 0 is the group and index 1 is the value name.
		     See: dba_key_split(3).

	      o $skip
		- The number of key-value pairs to ignore when using cdb databases. This value is ignored for all other  databases  which  do  not
		support multiple keys with the same name.

	      o $handle
		- The database handler, returned by dba_open(3) or dba_popen(3).

RETURN VALUES

	Returns the associated string if the key/data pair is found, FALSE otherwise.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 4.3.0	|						    |
       |	|						    |
       |	|  The	$skip  parameter  is  available  to support |
       |	| cdb's capability of multiple keys having the same |
       |	| name. 					    |
       |	|						    |
       +--------+---------------------------------------------------+
SEE ALSO

       dba_exists(3), dba_delete(3), dba_insert(3), dba_replace(3), dba_key_split(3).

PHP Documentation Group 													      DBA_FETCH(3)

cdbmake(1)						      General Commands Manual							cdbmake(1)

NAME

       cdbmake - create a constant database

SYNOPSIS

       cdbmake cdb cdb.tmp

DESCRIPTION

       cdbmake reads a series of encoded records from its standard input and writes a constant database to cdb.

       cdbmake	ensures  that  cdb is updated atomically, so programs reading cdb never have to wait for cdbmake to finish.  It does this by first
       writing the database to cdb.tmp and then moving cdb.tmp on top of cdb.  If cdb.tmp already exists, it is destroyed.  The  directories  con-
       taining cdb.tmp and cdb must be writable to cdbmake; they must also be on the same filesystem.

       cdbmake always makes sure that cdb.tmp is safely written to disk before it replaces cdb.  If the input is in a bad format or if cdbmake has
       any trouble writing cdb.tmp to disk, cdbmake complains and leaves cdb alone.

   RECORD FORMAT
       Records are indexed by keys.  A key is a string.  cdb is structured so that another program, starting from a key, can quickly find the rel-
       evant  record.	cdbmake allows several records with the same key, although most readers take only the first record, and cdbmake slows down
       somewhat if there are many records with the same key.

       cdbmake and cdbdump(1) preserve the order of records.

       A record is encoded for cdbmake as +klen,dlen:key->data followed by a newline.  Here klen is the number of bytes in key	and  dlen  is  the
       number of bytes in data.  The end of data is indicated by an extra newline.  For example:

	 +3,5:one->Hello
	 +3,7:two->Goodbye

       key and data may contain any characters, including colons, dashes, newlines, and nulls.

       Keys and data do not have to fit into memory.  A database cannot exceed 4 gigabytes.

       cdb is portable across machines.

SEE ALSO

       cdbdump(1), cdbget(1), cdbstats(1)

																	cdbmake(1)