initial translation in dba/functions

reference/dba/functions/dba-close.xml

@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="function.dba-close" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>dba_close</refname>
+  <refpurpose>Fecha um banco de dados DBA</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>void</type><methodname>dba_close</methodname>
+   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>dba_close</function> fecha o banco de dados e libera
+   todos os recursos do identificador de banco de dados especificado.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>dba</parameter></term>
+     <listitem>
+      <para>
+       O identificador do banco de dados, retornado por <function>dba_open</function> ou
+       <function>dba_popen</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.void;
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>dba_open</function></member>
+    <member><function>dba_popen</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->

reference/dba/functions/dba-delete.xml

@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="function.dba-delete" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>dba_delete</refname>
+  <refpurpose>Remove uma entrada DBA especificada por chave</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>dba_delete</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>dba_delete</function> remove do banco de dados a entrada especificada.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       A chave da entrada a ser removida.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dba</parameter></term>
+     <listitem>
+      <para>
+       O identificador do banco de dados, retornado por <function>dba_open</function> ou
+       <function>dba_popen</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>dba_exists</function></member>
+    <member><function>dba_fetch</function></member>
+    <member><function>dba_insert</function></member>
+    <member><function>dba_replace</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->

reference/dba/functions/dba-exists.xml

@@ -0,0 +1,81 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 9c4c9718261c2705fef2a490e3926751134aec32 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="function.dba-exists" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>dba_exists</refname>
+  <refpurpose>Verifica existência de uma chave</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>dba_exists</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>dba_exists</function> verifica se a chave especificada em
+   <parameter>key</parameter> existe no banco de dados.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       A chave para a qual a verificação é realizada.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dba</parameter></term>
+     <listitem>
+      <para>
+       O identificador do banco de dados, retornado por <function>dba_open</function> ou
+       <function>dba_popen</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna &true; se a chave existir, &false; caso contrário.
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>dba_delete</function></member>
+    <member><function>dba_fetch</function></member>
+    <member><function>dba_insert</function></member>
+    <member><function>dba_replace</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->

reference/dba/functions/dba-fetch.xml

@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: effc344e26a66510fa971719bb8af0960c7f2f46 Maintainer: leonardolara Status: ready --><!-- CREDITS: leonardolara -->
+<refentry xml:id="function.dba-fetch" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>dba_fetch</refname>
+  <refpurpose>Busca dados especificados por chave</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>string</type><type>false</type></type><methodname>dba_fetch</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>skip</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Assinatura sobrecarregada, preterida a partir do PHP 8.3.0:
+  </simpara>
+  <methodsynopsis>
+   <type>string</type><methodname>dba_fetch</methodname>
+   <methodparam><type class="union"><type>string</type><type>array</type></type><parameter>key</parameter></methodparam>
+   <methodparam><type>int</type><parameter>skip</parameter></methodparam>
+   <methodparam><type>resource</type><parameter>dba</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>dba_fetch</function> busca os dados especificados pela chave em
+   <parameter>key</parameter> do banco de dados especificado por
+   <parameter>dba</parameter>.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>key</parameter></term>
+     <listitem>
+      <para>
+       A chave pela qual os dados são especificados.
+      </para>
+      <note>
+       <para>
+        Ao trabalhar com arquivos INI, eta função aceita arrays como chaves
+        onde o índice 0 é o grupo e o índice 1 é o nome do valor. Consulte:
+        <function>dba_key_split</function>.
+       </para>
+      </note>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>dba</parameter></term>
+     <listitem>
+      <para>
+       O identificador do banco de dados, retornado por <function>dba_open</function> ou
+       <function>dba_popen</function>.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>skip</parameter></term>
+     <listitem>
+      <para>
+       O número de pares chave-valor a ignorar no uso de bancos de dados CDB.
+       Este valor é ignorado para todos os outros bancos de dados que não suportam
+       múltiplas chaves com o mesmo nome.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna a string associada se o par chave/dados for encontrado, &false;
+   caso contrário.
+  </para>
+ </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>8.3.0</entry>
+      <entry>
+       Chamar <function>dba_fetch</function> com <parameter>dba</parameter> no
+       3º argumento agora está defasado.
+      </entry>
+     </row>
+     <row>
+      <entry>8.2.0</entry>
+      <entry>
+       O argumento opcional "skip" de <function>dba_fetch</function> fica agora no final,
+       alinhado com a semântica das funções de usuário do PHP. A assinatura anterior com sobrecarga
+       ainda é aceita porém desencorajada.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>dba_exists</function></member>
+    <member><function>dba_delete</function></member>
+    <member><function>dba_insert</function></member>
+    <member><function>dba_replace</function></member>
+    <member><function>dba_key_split</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- 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:"~/.phpdoc/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
+-->