php-doc-en/reference/pgsql/functions/pg-send-query.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
  <refentry id='function.pg-send-query'>
   <refnamediv>
    <refname>pg_send_query</refname>
    <refpurpose>
     Send asynchronous query
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>bool</type><methodname>pg_send_query</methodname>
      <methodparam><type>resource</type><parameter>connection</parameter></methodparam>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
     </methodsynopsis>
     <methodsynopsis>
      <type>bool</type><methodname>pg_send_query</methodname>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>pg_send_query</function> send asynchronous query to the
     <parameter>connection</parameter>. Unlike
     <function>pg_query</function>, it can send multiple query to
     PostgreSQL and get the result one by one using
     <function>pg_get_result</function>. Script execution is not blocked
     while query is executing. Use
     <function>pg_connection_busy</function> to check connection is
     busy (i.e. query is executing). Query may be canceled by calling
     <function>pg_cancel_query</function>.
    </para>
    <para>
     Although user can send multiple query at once, user cannot send
     multiple query over busy connection. If query is sent while
     connection is busy, it waits until last query is finished and
     discards all result.
    </para>
    <para>
     See also <function>pg_query</function>,
     <function>pg_cancel_query</function>,
     <function>pg_get_result</function> and
     <function>pg_connection_busy</function>
    </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:"../../../../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
-->