pg-send-query.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: conni Status: ready -->
<refentry xml:id="function.pg-send-query" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_send_query</refname>
  <refpurpose>
   Sendet eine asynchrone Abfrage
  </refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>int</type><type>bool</type></type><methodname>pg_send_query</methodname>
   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
   <methodparam><type>string</type><parameter>query</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>pg_send_query</function> sendet eine oder mehrere asynchrone
   Abfragen über die Verbindung <parameter>connection</parameter>. Im
   Unterschied zu <function>pg_query</function> können hier mehrere
   Abfragen auf einmal an PostgreSQL gesendet und die Ergebnisse
   nacheinander mit <function>pg_get_result</function> geholt werden.
  </para>
  <para>
   Die Ausführung eines Skripts wird während der Abarbeitung der Anfragen
   nicht blockiert. Benutzen Sie die Funktion
   <function>pg_connection_busy</function>, um zu prüfen, ob die Verbindung
   gerade benutzt wird (&zb; ob gerade eine Abfrage ausgeführt wird). Mit der
   Funktion <function>pg_cancel_query</function> können Abfragen gelöscht
   werden.
  </para>
  <para>
   Obwohl man mehrere Abfragen auf einmal an den Server senden kann, können
   die Abfragen nicht über eine gerade benutzte Verbindung geschickt werden.
   Falls eine Abfrage gesendet wird, während die Verbindung benutzt wird, wird
   abgewartet, bis die letzte Abfrage fertig ist, und alle Ergebnisse werden
   verworfen.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>connection</parameter></term>
     <listitem>
      &pgsql.parameter.connection;
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>query</parameter></term>
     <listitem>
      <para>
       Das oder die SQL-Anweisung(en), die ausgeführt werden sollen.
      </para>
      <para>
       Daten innerhalb der Abfrage sollten
       <link linkend="function.pg-escape-string">ordnungsgemäß maskiert</link>
       sein.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Gibt bei Erfolg &true; zurück und &false; oder <literal>0</literal>, falls
   ein Fehler auftrat.
   Benutzen Sie <function>pg_get_result</function> um die Abfrageergebnisse
   zu ermitteln.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     &pgsql.changelog.connection-object;
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>pg_send_query</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
  $dbconn = pg_connect("dbname=publisher") or die("Verbindungsaufbau fehlgeschlagen");

  if (!pg_connection_busy($dbconn)) {
      pg_send_query($dbconn, "select * from authors; select count(*) from authors;");
  }

  $res1 = pg_get_result($dbconn);
  echo "Der erste Aufruf von pg_get_result(): $res1\n";
  $rows1 = pg_num_rows($res1);
  echo "$res1 hat $rows1 Zeilen\n\n";

  $res2 = pg_get_result($dbconn);
  echo "Der zweite Aufruf von pg_get_result(): $res2\n";
  $rows2 = pg_num_rows($res2);
  echo "$res2 hat $rows2 Zeilen\n";
?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
Der erste Aufruf von pg_get_result(): Resource id #3
Resource id #3 hat 3 Zeilen

Der zweite Aufruf von pg_get_result(): Resource id #4
Resource id #4 hat 1 Zeilen
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>pg_query</function></member>
     <member><function>pg_cancel_query</function></member>
    <member><function>pg_get_result</function></member>
    <member><function>pg_connection_busy</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
-->