svn: /phpdoc/de/trunk/reference/mysql/functions/ mysql-tablename.xml

wiesemann                                Mon, 02 Aug 2010 21:49:21 +0000

Revision: http://svn.php.net/viewvc?view=revision&revision=301809

Log:
take over, sync to EN (and close bug #52455)

Bug: http://bugs.php.net/52455 (Open) wrong Example
      
Changed paths:
    U   phpdoc/de/trunk/reference/mysql/functions/mysql-tablename.xml

Modified: phpdoc/de/trunk/reference/mysql/functions/mysql-tablename.xml
===================================================================
--- phpdoc/de/trunk/reference/mysql/functions/mysql-tablename.xml	2010-08-02 21:46:54 UTC (rev 301808)
+++ phpdoc/de/trunk/reference/mysql/functions/mysql-tablename.xml	2010-08-02 21:49:21 UTC (rev 301809)
@@ -1,54 +1,111 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 301806 Maintainer: wiesemann Status: ready -->

-  <refentry xml:id="function.mysql-tablename" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>mysql_tablename</refname>
-    <refpurpose>Liefert den Namen einer Tabelle</refpurpose>
-   </refnamediv>
-   <refsect1 role="description">
-    &reftitle.description;
-     <methodsynopsis>
-      <type>string</type><methodname>mysql_tablename</methodname>
-      <methodparam><type>resource</type><parameter>Ergebnis-Kennung</parameter></methodparam>
-      <methodparam><type>int</type><parameter>i</parameter></methodparam>
-     </methodsynopsis>
-    <para>
-     <function>mysql_tablename</function> ermittelt aus einer
-     Ergebnis-Kennung, die von <function>mysql_list_tables</function>
-     geliefert wurde, sowie einem Index vom Typ integer, den Namen der Tabelle.
-     Die Funktion <function>mysql_num_rows</function> kann verwendet werden,
-     um die Anzahl der Tabellen in der Ergebnis-Kennung zu ermitteln. Benutzen
-     Sie die Funktion <function>mysql_tablename</function> um diese Ergebnis-Kennung
-     zu durchlaufen, oder irgendeine andere Funktion, die mit Ergebnistabellen
-     umgehen kann, wie zum Beispiel <function>mysql_fetch_array</function>.
-     <example>
-      <title><function>mysql_tablename</function> Bespiel</title>
-      <programlisting role="php">
+<refentry xml:id="function.mysql-tablename" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>mysql_tablename</refname>
+  <refpurpose>Liefert den Namen einer Tabelle</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>string</type><methodname>mysql_tablename</methodname>
+   <methodparam><type>resource</type><parameter>result</parameter></methodparam>
+   <methodparam><type>int</type><parameter>i</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Liest den Tabellennamen aus einem Ergebnis (<parameter>result</parameter>).
+  </para>
+  <para>
+   Diese Funktion ist veraltet. Es wird empfohlen, stattdessen eine SQL-Query wie
+   <literal>SHOW TABLES [FROM db_name] [LIKE 'pattern']</literal> zu verwenden.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>result</parameter></term>
+     <listitem>
+      <para>
+       Ein Ergebniszeiger (<type>resource</type>), der von
+       <function>mysql_list_tables</function> zurückgegeben wird.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>i</parameter></term>
+     <listitem>
+      <para>
+       Der Integer-Index (Zeilen-/Tabellennummer).
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Der Tabellenname bei Erfolg. &return.falseforfailure;.
+  </para>
+  <para>
+   Nutzen Sie die <function>mysql_tablename</function>-Funktion,
+   um den Ergebniszeiger zu durchlaufen, oder nutzen Sie eine
+   andere Ergebnisfunktion wie <function>mysql_fetch_array</function>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>mysql_tablename</function>-Beispiel</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 mysql_connect("localhost", "mysql_user", "mysql_password");
 $result = mysql_list_tables("mydb");
 $num_rows = mysql_num_rows($result);
 for ($i = 0; $i < $num_rows; $i++) {
-    echo "Table: ", mysql_tablename($result, $i), "\n";
+    echo "Tabelle: ", mysql_tablename($result, $i), "\n";
+}

 mysql_free_result($result);
 ?>
-?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-    <para>
-     Siehe auch <function>mysql_list_tables</function>,
-     <function>mysql_field_table</function> und
-    <function>mysql_db_name</function>.
-    </para>
-   </refsect1>
-  </refentry>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>

+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Die <function>mysql_num_rows</function>-Funktion kann genutzt werden,
+    um die Anzahl der Tabellen im Ergebnis-Pointer zu bestimmen.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>mysql_list_tables</function></member>
+    <member><function>mysql_field_table</function></member>
+    <member><function>mysql_db_name</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -60,7 +117,7 @@
 sgml-indent-data:t
 indent-tabs-mode:nil
 sgml-parent-document:nil
-sgml-default-dtd-file:"../../../../manual.ced"
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
 sgml-exposed-tags:nil
 sgml-local-catalogs:nil
 sgml-local-ecat-files:nil