1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- 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 will return the number of rows affected by
the query for INSERT, UPDATE and DELETE statements. In order to retain backward
compatibility, it will return &true; for these statements if the query succeeded
without affecting any rows.
</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
-->
|
