cynic Thu Jan 25 20:45:52 2001 EDT
Added files:
/phpdoc/cs/functions dbm.xml
Log:
translated (win-1250)
Index: phpdoc/cs/functions/dbm.xml
+++ phpdoc/cs/functions/dbm.xml
<reference id="ref.dbm">
<title>DBM Funkce</title>
<titleabbrev>DBM</titleabbrev>
<partintro>
<simpara>
Tyto funkce v�m umo��uj� ukl�dat z�znamy do datab�z� typu dbm. Tento typ
datab�z� (podporovan� Berkeley DB, GDBM, n�kter�mi syst�mov�mi knihovnami,
a tak� vestav�nou flatfile knihovnou) ukl�d� kl��/hodnota p�ry (oproti
plnohodnotn�m rela�n�m datab�z�m).
</simpara>
<para>
<example>
<title>Uk�zka DBM</title>
<programlisting role="php">
$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);
</programlisting>
</example>
</para>
</partintro>
<refentry id="function.dbmopen">
<refnamediv>
<refname>dbmopen</refname>
<refpurpose>Otev��t DBM datab�zi</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dbmopen</function></funcdef>
<paramdef>string <parameter>filename</parameter></paramdef>
<paramdef>string <parameter>flags</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Prvn� argument je n�zev DBM souboru (pln� cesta), kter� se m� otev��t,
druh� argument je jedno z "r" (pouze pro �ten�), "n" (nov�, implikuje
�ten�/z�pis, a nejsp� sma�e existuj�c� datab�zi stejn�ho jm�na), "c"
(vytvo�it, implikuje �ten�/z�pis, a nesma�e existuj�c� datab�zi stejn�ho
jm�na) nebo "w" (�ten�/z�pis).
</para>
<para>
P�i �sp�chu vrac� identifik�tor, kter� se p�ed�v� dal��m DBM funkc�m
success, jinak <literal>false</literal>.
</para>
<para>
Pokud pou��v�te NDBM, NDBM ve skute�nosti vytv��� soubory soubor.dir
a soubor.pag. GDBM pou��v� pouze jeden soubr, stejn� jako intern� flatfile
podpora, a Berkeley DB vytv��� soubor <filename>filename.db</filename>.
Pozn.: Vedle p��padn�ho zamyk�n� soubor� vlastn� DBM knihovnou prov�d� PHP
svoje vlastn� zamyk�n� soubor�. PHP nema�e <filename>.lck</filename>
soubory, kter� vytv���. Pou��v� tyto soubory jako pevn� inodes, na kter�ch
prov�d� zamyk�n� soubor�. V�ce informac� o DBM souborech viz va�e Unixov�
man str�nky, nebo si st�hn�te <ulink url="&url.gdbm;">GNU GDBM</ulink>.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmclose">
<refnamediv>
<refname>dbmclose</refname>
<refpurpose>Zav��t dbm datab�zi</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dbmclose</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Odemkne a zav�e ur�enou datab�zi.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmexists">
<refnamediv>
<refname>dbmexists</refname>
<refpurpose>
Zjist�, jestli pro zadan� kl�� existuje v DBM datab�zi hodnota
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dbmexists</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� <literal>true</literal>, pokud existuje hodnota spojen� s
<parameter>key</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmfetch">
<refnamediv>
<refname>dbmfetch</refname>
<refpurpose>
Z�skat z DBM datab�ze hodnotu spojenou s ur�it�m kl��em
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dbmfetch</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� hodnotu spojenou s <parameter>key</parameter>.
</para>
</refsect1>
</refentry>
<refentry id="function.dbminsert">
<refnamediv>
<refname>dbminsert</refname>
<refpurpose>
Vlo�it do DBM datab�ze hodnotu a kl��
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>dbminsert</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
<paramdef>string <parameter>value</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
P�id� do datab�ze hodnotu s ur�en�m kl��em.
</para>
<para>
Vrac� -1, pokud byla datab�ze otev�ena pouze pro �ten�, 0, pokud bylo
vlo�en� �sp�n�, a 1, pokud u� ur�en� kl�� existuje. (K nahra�en� hodnoty
pou�ijte <function>dbmreplace</function>.)
</para>
</refsect1>
</refentry>
<refentry id="function.dbmreplace">
<refnamediv>
<refname>dbmreplace</refname>
<refpurpose>
Nahredit v DBM datab�zi hodnotu s ur�it�m kl��em
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dbmreplace</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
<paramdef>string <parameter>value</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Nahrad� v datab�zi hodnotu spojenou s ur�en�m kl��em.
</para>
<para>
Pokud tento kl��e v datab�zi neexistuje, p�id� ho.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmdelete">
<refnamediv>
<refname>dbmdelete</refname>
<refpurpose>
Smazat v DMB datab�zi hodnotu spojenou s ur�it�m kl��em
</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>dbmdelete</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vyma�e z datab�ze hodnotu s kl��em <parameter>key</parameter>.
</para>
<para>
Pokud tento kl�� v datab�zi neexistuje, vrac� <literal>false</literal>.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmfirstkey">
<refnamediv>
<refname>dbmfirstkey</refname>
<refpurpose>Z�skat z DBM datab�ze prvn� kl��</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dbmfirstkey</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� prvn� kl�� v datab�zi. Pozn.: Nen� zaru�eno ��dn� po�ad�, proto�e
datab�ze m��e b�t vytvo�ena pomoc� hash tabulky, co� nezaru�uje ��dn�
�azen�.
</para>
</refsect1>
</refentry>
<refentry id="function.dbmnextkey">
<refnamediv>
<refname>dbmnextkey</refname>
<refpurpose>Z�skat dal�� kl�� z DBM datab�ze</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dbmnextkey</function></funcdef>
<paramdef>int <parameter>dbm_identifier</parameter></paramdef>
<paramdef>string <parameter>key</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
Vrac� kl�� n�s�eduj�c� po <parameter>key</parameter>. Zavol�n�m
<function>dbmfirstkey</function> n�sledovan�m postupn�m vol�n�m
<function>dbmnextkey</function> se daj� z�skat v�echny key/value p�ry v DBM
datab�zi. Nap��klad:
<example>
<title>Z�sk�n� v�ech key/value p�r� v DBM datab�zi</title>
<programlisting role="php">
$key = dbmfirstkey ($dbm_id);
while ($key) {
echo "$key = " . dbmfetch ($dbm_id, $key) . "\n";
$key = dbmnextkey ($dbm_id, $key);
}
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<refentry id="function.dblist">
<refnamediv>
<refname>dblist</refname>
<refpurpose>Z�skat n�zev pou��van� DBM-kompatibiln� knihovny</refpurpose>
</refnamediv>
<refsect1>
<title>Popis</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>dblist</function></funcdef>
<paramdef>void</paramdef>
</funcprototype>
</funcsynopsis>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
