mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-27 14:28:56 +00:00
85c99abda9
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@20971 c90b9560-bf6c-de11-be94-00142212c4b1
377 lines
10 KiB
XML
377 lines
10 KiB
XML
<reference id="ref.ibase">
|
|
<title>InterBase functions</title>
|
|
<titleabbrev>InterBase</titleabbrev>
|
|
|
|
<partintro>
|
|
<para>
|
|
InterBase is a popular database put out by Borland/Inprise. More
|
|
information about InterBase is available at <ulink
|
|
url="&url.ibase;">&url.ibase;</ulink>. Oh, by the way, Interbase
|
|
just joined the open source movement!
|
|
</para>
|
|
</partintro>
|
|
|
|
<refentry id="function.ibase-connect">
|
|
<refnamediv>
|
|
<refname>ibase_connect</refname>
|
|
<refpurpose>
|
|
Open a connection to an InterBase database
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_connect</function></funcdef>
|
|
<paramdef>string <parameter>database</parameter></paramdef>
|
|
<paramdef>string
|
|
<parameter><optional>username</optional></parameter>
|
|
</paramdef>
|
|
<paramdef>string
|
|
<parameter><optional>password</optional></parameter>
|
|
</paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Opens a connection to an InterBase database.
|
|
<example>
|
|
<title><function>Ibase_connect</function> example</title>
|
|
<programlisting role="php">
|
|
$dbh = ibase_connect ($host, $username, $password);
|
|
$stmt = 'SELECT * FROM tblname';
|
|
$sth = ibase_query ($dbh, $stmt);
|
|
while ($row = ibase_fetch_object ($sth)) {
|
|
print $row->email . "\n";
|
|
}
|
|
ibase_close ($dbh);
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<para>
|
|
See also: <function>ibase_pconnect</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-pconnect">
|
|
<refnamediv>
|
|
<refname>ibase_pconnect</refname>
|
|
<refpurpose>
|
|
Creates an persistent connection to an InterBase database
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_connect</function></funcdef>
|
|
<paramdef>string <parameter>database</parameter></paramdef>
|
|
<paramdef>string
|
|
<parameter><optional>username</optional></parameter>
|
|
</paramdef>
|
|
<paramdef>string
|
|
<parameter><optional>password</optional></parameter>
|
|
</paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Opens a persistent connection to an Interbase database.
|
|
</simpara>
|
|
<para>
|
|
See also <function>ibase_connect</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-close">
|
|
<refnamediv>
|
|
<refname>ibase_close</refname>
|
|
<refpurpose>
|
|
Close a connection to an InterBase database
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_close</function></funcdef>
|
|
<paramdef>int
|
|
<parameter><optional>connection_id</optional></parameter>
|
|
</paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Close a connection to an InterBase database. This function takes
|
|
a connection id returned from <function>ibase_connect</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-query">
|
|
<refnamediv>
|
|
<refname>ibase_query</refname>
|
|
<refpurpose>Execute a query on an InterBase database</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_query</function></funcdef>
|
|
<paramdef>int
|
|
<parameter><optional>link_identifier</optional></parameter>
|
|
</paramdef>
|
|
<paramdef>string <parameter>query</parameter> </paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>bind_args</optional></parameter>
|
|
</paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Performs a query on a InterBase database, returning a result
|
|
identifier for use with <function>ibase_fetch_row</function>,
|
|
<function>ibase_free_result</function> and
|
|
<function>ibase_free_query</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-fetch-row">
|
|
<refnamediv>
|
|
<refname>ibase_fetch_row</refname>
|
|
<refpurpose>Fetch a row from an InterBase database</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_fetch_row</function></funcdef>
|
|
<paramdef>int <parameter>result_identifier</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Returns the next row specified by the result identifier obtained
|
|
using the <function>ibase_query</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-fetch-object">
|
|
<refnamediv>
|
|
<refname>ibase_fetch_object</refname>
|
|
<refpurpose>Get an object from a InterBase database</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_fetch_object</function></funcdef>
|
|
<paramdef>int <parameter>result_id</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Fetches a row as a pseudo-object from a
|
|
<parameter>result_id</parameter> obtained either by
|
|
<function>ibase_query</function> or
|
|
<function>ibase_execute</function>.
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
$dbh = ibase_connect ($host, $username, $password);
|
|
$stmt = 'SELECT * FROM tblname';
|
|
$sth = ibase_query ($dbh, $stmt);
|
|
while ($row = ibase_fetch_object ($sth)) {
|
|
print $row->email . "\n";
|
|
}
|
|
ibase_close ($dbh);
|
|
</programlisting>
|
|
</informalexample>
|
|
</para>
|
|
<para>
|
|
See also <function>ibase_fetch_row</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-free-result">
|
|
<refnamediv>
|
|
<refname>ibase_free_result</refname>
|
|
<refpurpose>Free a result set</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_free_result</function></funcdef>
|
|
<paramdef>int <parameter>result_identifier</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Free's a result set the has been created by
|
|
<function>ibase_query</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-prepare">
|
|
<refnamediv>
|
|
<refname>ibase_prepare</refname>
|
|
<refpurpose>
|
|
Prepare a query for later binding of parameter placeholders and
|
|
execution
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_prepare</function></funcdef>
|
|
<paramdef>int
|
|
<parameter><optional>link_identifier</optional></parameter>
|
|
</paramdef>
|
|
<paramdef>string <parameter>query</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Prepare a query for later binding of parameter placeholders (via
|
|
<function>ibase_bind</function>) and execution (via
|
|
<function>ibase_execute</function>).
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-bind">
|
|
<refnamediv>
|
|
<refname>ibase_bind</refname>
|
|
<refpurpose>
|
|
Bind placeholder parameters from a previously prepared query
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_bind</function></funcdef>
|
|
<paramdef>int <parameter>query</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Bind Parameters from a query prepared by
|
|
<function>ibase_prepare</function>.
|
|
</simpara>
|
|
<note>
|
|
<para>
|
|
<function>Ibase_bind</function> is currently not functional in
|
|
PHP4
|
|
</para>
|
|
</note>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-execute">
|
|
<refnamediv>
|
|
<refname>ibase_execute</refname>
|
|
<refpurpose>Execute a previously prepared query</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_execute</function></funcdef>
|
|
<paramdef>int <parameter>query</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Execute a query prepared (and perhaps binded) by
|
|
<function>ibase_prepare</function> and
|
|
<function>ibase_bind</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-free-query">
|
|
<refnamediv>
|
|
<refname>ibase_free_query</refname>
|
|
<refpurpose>
|
|
Free memory allocated by a prepared query
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_free_query</function></funcdef>
|
|
<paramdef>int <parameter>query</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Free a query prepared by <function>ibase_prepare</function>.
|
|
</simpara>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-timefmt">
|
|
<refnamediv>
|
|
<refname>ibase_timefmt</refname>
|
|
<refpurpose>
|
|
Sets the format of datetime columns returned from queries
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_timefmt</function></funcdef>
|
|
<paramdef>string <parameter>format</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<simpara>
|
|
Sets the format of the datetime columns returned from queries.
|
|
</simpara>
|
|
<note>
|
|
<para>
|
|
<function>Ibase_timefmt</function> is currently not functional
|
|
in PHP4.
|
|
</para>
|
|
</note>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.ibase-num-fields">
|
|
<refnamediv>
|
|
<refname>ibase_num_fields</refname>
|
|
<refpurpose>
|
|
Get the number of rows in a result set
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcdef>int <function>ibase_num_fields</function></funcdef>
|
|
<paramdef>int <parameter>result_id</parameter></paramdef>
|
|
</funcsynopsis>
|
|
<para>
|
|
Returns an integer containing the number of fields in a result
|
|
set.
|
|
<informalexample>
|
|
<programlisting role="php">
|
|
$dbh = ibase_connect ($host, $username, $password);
|
|
$stmt = 'SELECT * FROM tblname';
|
|
$sth = ibase_query ($dbh, $stmt);
|
|
|
|
if (ibase_num_fields($sth) > 0) {
|
|
while ($row = ibase_fetch_object ($sth)) {
|
|
print $row->email . "\n";
|
|
}
|
|
} else {
|
|
die ("No Results were found for your query");
|
|
}
|
|
|
|
ibase_close ($dbh);
|
|
</programlisting>
|
|
</informalexample>
|
|
</para>
|
|
<para>
|
|
See also: <function>ibase_field_info</function>.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
<function>Ibase_num_fields</function> is currently not functional
|
|
in PHP4.
|
|
</para>
|
|
</note>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
</reference>
|
|
|
|
<!-- 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
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|