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