cortesi Mon Apr 1 14:25:25 2002 EDT
Modified files:
/phpdoc/it/functions dbm.xml
Log:
adding translation by Mariano Calandra up to EN 1.17
Index: phpdoc/it/functions/dbm.xml
diff -u /dev/null phpdoc/it/functions/dbm.xml:1.6
--- /dev/null Mon Apr 1 14:25:25 2002
+++ phpdoc/it/functions/dbm.xml Mon Apr 1 14:25:25 2002
@@ -0,0 +1,300 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!-- EN-Revision: 1.17 Maintainer: calandra Status: ready -->
+ <reference id="ref.dbm">
+ <title>Funzioni DBM</title>
+ <titleabbrev>DBM</titleabbrev>
+
+ <partintro>
+ <simpara>
+ Questa funzioni consentono lo storage di records memorizzati
+ in un dbm-style database. Questo tipo di database (supportato da Berkeley DB,
+ GDBM, e qualche libreria di sistema, cos� come una built-in flatfile library)
+ memorizza coppie key/value (al contrario dei full-blown records supportati dai
+ database relazionali).
+ </simpara>
+ <para>
+ <example>
+ <title>Esempio DBM</title>
+ <programlisting role="php">
+<![CDATA[
+$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>Apre un database DBM</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>dbmopen</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam><type>string</type><parameter>flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Il primo argomento � il nome (con il percorso completo) del file DBM da aprire e
+ il secondo � l' open mode del file che pu� essere "r", "n", "c" or "w" per sola
+ lettura, nuovo (implica lettura-scrittura, e
+ molto probabilmente troncher� un database
+ esistente con lo stesso nome), crea (implica
+ lettura-scrittura, e non troncher� un database
+ esistente con lo stesso nome) e lettura-scrittura rispettivamente.
+ </para>
+ <para>
+ Restituisce un identifier da passare alle altre funzioni DBM in caso di
+ successo, o &false; se fallisce.
+ </para>
+ <para>
+ Se � usato il supporto NDBM, NDBM creer� filename.dir e filename.pag files.
+ GDBM usa solo un file, in quanto fa l' internal flat-file support,
+ e il Berkeley DB crea un
+ <filename>filename.db</filename> file. Da notare che PHP fa il suo file
+ locking in aggiunta a quello che eventualmente potrebbe fare la stessa
+ libreria DBM. PHP non cancella i files
+ <filename>.lck</filename> che crea. Semplicemente usa questi
+ files come fixed inodes su cui fare il file locking. Per maggiori informazioni
+ sui files DBM, guarda le pagine del tuo manuale UNIX, o scarica
+ <ulink url="&url.gdbm;">GNU's GDBM</ulink>.
+ </para>
+ ¬e.sm.uidcheck;
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmclose">
+ <refnamediv>
+ <refname>dbmclose</refname>
+ <refpurpose>Chiude un database dbm</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>dbmclose</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sblocca e chiude il database specificato.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmexists">
+ <refnamediv>
+ <refname>dbmexists</refname>
+ <refpurpose>
+ Dice se esiste un valore per una chiave in un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>dbmexists</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce &true; se c'� un valore associato con la
+ <parameter>key</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmfetch">
+ <refnamediv>
+ <refname>dbmfetch</refname>
+ <refpurpose>
+ Estrae un valore per una chiave da un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>string</type><methodname>dbmfetch</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce il valore associato con <parameter>key</parameter>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbminsert">
+ <refnamediv>
+ <refname>dbminsert</refname>
+ <refpurpose>
+ Inserisce un valore per una chiave in un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>dbminsert</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ <methodparam><type>string</type><parameter>value</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Aggiunge il valore al database con la chiave specificata.
+ </para>
+ <para>
+ Restituisce -1 se il database � stato aperto in modalit� read-only
+ (sola lettura), 0 se l'inserimento � andato a buon fine, e 1 se la chiave
+ specificata gi� esiste. (Per sostituire il valore, usa
+<function>dbmreplace</function>.)
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmreplace">
+ <refnamediv>
+ <refname>dbmreplace</refname>
+ <refpurpose>
+ Sostituisce il valore per una chiave in un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>int</type><methodname>dbmreplace</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ <methodparam><type>string</type><parameter>value</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Sostituisce il valore per la chiave specificata nel database.
+ </para>
+ <para>
+ Aggiunger� inoltre la chiave al database se la stessa non
+ esisteva gi�.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmdelete">
+ <refnamediv>
+ <refname>dbmdelete</refname>
+ <refpurpose>
+ Cancella il valore per una chiave da un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>dbmdelete</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Cancella il valore per <parameter>key</parameter> nel database.
+ </para>
+ <para>
+ Restituisce &false; se la chiave non esisteva nel database.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmfirstkey">
+ <refnamediv>
+ <refname>dbmfirstkey</refname>
+ <refpurpose>
+ Recupera la prima chiave da un database DBM
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>string</type><methodname>dbmfirstkey</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce la prima chiave nel database. Da notare che nessun
+ ordine particolare � garantito dal momento che il database potrebbe
+ essere stato costruito usando una hash-table, che non garantisce nessun ordine.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.dbmnextkey">
+ <refnamediv>
+ <refname>dbmnextkey</refname>
+ <refpurpose>
+ Recupera la chiave successiva da un database DBM</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>string</type><methodname>dbmnextkey</methodname>
+ <methodparam><type>int</type><parameter>dbm_identifier</parameter></methodparam>
+ <methodparam><type>string</type><parameter>key</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Restituisce la chiave successiva dopo <parameter>key</parameter>. Chiamando la
+funzione
+ <function>dbmfirstkey</function> seguita da successive chiamate alla funzione
+ <function>dbmnextkey</function> � possibile visionare ciascuna coppia key/value
+ nel database DBM. Per esempio:
+ <example>
+ <title>Esaminare ogni coppia key/value in un database DBM</title>
+ <programlisting role="php">
+<![CDATA[
+$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>
+ Descrive la libreria DBM-compatibile in uso.
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Descrizione</title>
+ <methodsynopsis>
+ <type>string</type><methodname>dblist</methodname>
+ <void/>
+ </methodsynopsis>
+ </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
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
