php-doc-en/reference/ibase/functions/ibase-query.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- splitted from ./en/functions/ibase.xml, last change in rev 1.2 -->
  <refentry id="function.ibase-query">
   <refnamediv>
    <refname>ibase_query</refname>
    <refpurpose>Execute a query on an InterBase database</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Description</title>
     <methodsynopsis>
      <type>resource</type><methodname>ibase_query</methodname>
      <methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter></methodparam>
      <methodparam><type>string</type><parameter>query</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>bind_args</parameter></methodparam>
     </methodsynopsis>
    <simpara>
     Performs a query on an InterBase database. If the query raises an error,
     returns &false;. If it is successful and there is a (possibly empty)
     result set (such as with a SELECT query), returns a result identifier. If
     the query was successful and there were no results, returns &true;.
    </simpara>
    <para>
     <example>
      <title><function>ibase_query</function> example</title>
      <programlisting role="php">
<![CDATA[
<?php

    $host = 'localhost:/path/to/your.gdb';

    $dbh = ibase_connect($host, $username, $password);
    $stmt = 'SELECT * FROM tblname';

    $sth = ibase_query($dbh, $stmt) or die(ibase_errmsg());

?>
]]>
      </programlisting>
     </example>
    </para>
    <note>
      <para>
      In PHP 5.0.0 and up, this function returns the number of rows affected by
      the query (if > 0 and applicable to the statement type). A query that succeeded,
      but did not affect any rows (e.g. an UPDATE of a non-existent record) will return
      &true;.
      </para>
    </note>
    <note>
     <para>
      If you get some error like "arithmetic exception, numeric overflow,
      or string truncation. Cannot transliterate character between character
      sets" (this occurs when you try use some character with accents)
      when using this and after <function>ibase_query</function> you must
      set the character set (i.e. ISO8859_1 or your current character set).
     </para>
    </note>
    <para>
     See also <function>ibase_errmsg</function>,
     <function>ibase_fetch_row</function>,
     <function>ibase_fetch_object</function>, and
     <function>ibase_free_result</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
-->