svn: /phpdoc/de/trunk/reference/pdo/pdo/ exec.xml

nikic                                    Sun, 03 Jul 2011 20:18:57 +0000

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

Log:
Translate PDO::exec to DE

Changed paths:
    A   phpdoc/de/trunk/reference/pdo/pdo/exec.xml

Added: phpdoc/de/trunk/reference/pdo/pdo/exec.xml
===================================================================
--- phpdoc/de/trunk/reference/pdo/pdo/exec.xml	                        (rev 0)
+++ phpdoc/de/trunk/reference/pdo/pdo/exec.xml	2011-07-03 20:18:57 UTC (rev 312865)
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EM-Revision: 297028 Maintainer: nikic Status: ready -->
+<refentry xml:id="pdo.exec" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>PDO::exec</refname>
+  <refpurpose>
+   Führt ein SQL Statement aus und gibt die Zahl der betroffenen Zeilen zurück
+  </refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>PDO::exec</methodname>
+   <methodparam><type>string</type><parameter>statement</parameter></methodparam>
+  </methodsynopsis>
+
+  <para>
+   <function>PDO::exec</function> führt ein SQL Statement aus und gibt
+   die Anzahl der betroffenen Zeilen zurück.
+  </para>
+  <para>
+   <function>PDO::exec</function> gibt nicht die Ergebnisse eines SELECT
+   Statements zurück. Um diese zu erhalten kann entweder <function>PDO::query</function>
+   genutzt werden, oder ein ein PDOStatement, welches über <function>PDO::prepare</function>
+   erstellt und über <function>PDOStatement::execute</function> ausgeführt wird.
+  </para>
+
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>statement</parameter></term>
+      <listitem>
+       <para>
+        Das SQL Statement, welches ausgeführt werden soll.
+       </para>
+       <para>
+        Alle Usereingaben in diesem Query müssen mit
+        <function>PDO::quote</function> maskiert werden.
+       </para>
+      </listitem>
+     </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   <function>PDO::exec</function> gibt die Anzahl von Zeilen zurück, welche
+   durch diese Abfrage geändert oder gelöscht wurden. Wenn keine Zeilen
+   geändert wurden, gibt <function>PDO::exec</function> <literal>0</literal>
+   zurück.
+  </para>
+
+  &return.falseproblem;
+  <para>
+   Das folgende Beispiel verlässt sich fälschlicherweise auf den Rückgabewert
+   von <function>PDO::exec</function>, weswegen ein Statement, welches 0 Zeilen
+   ändert, einen Aufruf von <function>die</function> nach sich zieht:
+   <programlisting role="php">
+<![CDATA[
+<?php
+$db->exec() or die(print_r($db->errorInfo(), true));
+?>
+]]>
+   </programlisting>
+  </para>
+
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Ein DELETE Statement ausführen</title>
+    <para>
+     Führt das DELETE Statement aus und gibt die Anzahl der gelöschten
+     Zeilen aus.
+    </para>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');
+
+/* Entferne alle roten Früchte aus der Tabelle */
+$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");
+
+/* Und gebe die Anzahl an gelöschten Zeilen zurück */
+echo "$count Zeilen wurden gelöscht.\n";
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+10 Zeilen wurden gelöscht.
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>PDO::prepare</function></member>
+    <member><function>PDO::query</function></member>
+    <member><function>PDOStatement::execute</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
+-->


Property changes on: phpdoc/de/trunk/reference/pdo/pdo/exec.xml
___________________________________________________________________
Added: svn:keywords
   + Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
Added: svn:eol-style
   + native