[prev in list] [next in list] [prev in thread] [next in thread]
List: phpdoc
Subject: [PHPDOC] cvs: /phpdoc/de/functions ibase.xml
From: "Egon Schmid" <eschmid () s ! netic ! de>
Date: 2000-02-29 21:43:06
[Download RAW message or body]
eschmid Tue Feb 29 13:43:06 2000 EDT
Modified files:
/phpdoc/de/functions ibase.xml
Log:
Copy changes to the german tree.
Index: phpdoc/de/functions/ibase.xml
diff -u phpdoc/de/functions/ibase.xml:1.3 phpdoc/de/functions/ibase.xml:1.4
--- phpdoc/de/functions/ibase.xml:1.3 Mon Feb 28 06:55:33 2000
+++ phpdoc/de/functions/ibase.xml Tue Feb 29 13:42:34 2000
@@ -4,13 +4,19 @@
<partintro>
<para>
+ Interbase is a popular database put out by Borland/Inprise. More
+ information about Interbase is available at
+ http://www.interbase.com. 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>
+ <refpurpose>
+ Open a connection to an Interbase database
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -27,15 +33,15 @@
<para>
Opens a connection to an Interbase database.
<example>
- <title><function>ibase_connect</function> example</title>
+ <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->name . "\n";
+$sth = ibase_query ($dbh, $stmt);
+while ($row = ibase_fetch_object ($sth)) {
+ print $row->email . "\n";
}
-ibase_close($dbh);
+ibase_close ($dbh);
</programlisting>
</example>
</para>
@@ -48,15 +54,21 @@
<refentry id="function.ibase-pconnect">
<refnamediv>
<refname>ibase_pconnect</refname>
- <refpurpose></refpurpose>
+ <refpurpose>
+ Makes an persistent Interbase database connection
+ </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> + \
<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.
@@ -70,16 +82,21 @@
<refentry id="function.ibase-close">
<refnamediv>
<refname>ibase_close</refname>
- <refpurpose>Close a connection to an Interbase database</refpurpose>
+ <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>
+ <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 ibase_connect. + Close a connection to an Interbase database. \
This function takes + a connection id returned from \
<function>ibase_connect</function>. </para>
</refsect1>
</refentry>
@@ -87,15 +104,19 @@
<refentry id="function.ibase-query">
<refnamediv>
<refname>ibase_query</refname>
- <refpurpose> Execute a query on an Interbase database</refpurpose>
+ <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>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
<paramdef>string <parameter>query</parameter> </paramdef>
- <paramdef>int <parameter><optional>bind_args</optional></parameter> </paramdef>
+ <paramdef>int
+ <parameter><optional>bind_args</optional></parameter>
+ </paramdef>
</funcsynopsis>
<simpara>
Performs a query on a Interbase database, returning a result
@@ -116,26 +137,61 @@
<funcsynopsis>
<funcdef>int <function>ibase_fetch_row</function></funcdef>
<paramdef> <parameter>int 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>
- <simpara>
- Returns the next row specified by the result identifier obtained using the \
<function>ibase_query</function>.
- </simpara>
+ <para>
+ Fetches a row as a psuedo-object from a result id 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>
+ <refpurpose>Free a result set</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<funcsynopsis>
- <funcdef>int <function>ibase_free_result</function></funcdef>
- <paramdef> <parameter>int result_identifier</parameter></paramdef>
+ <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>.
+ Free's a result set the has been created by
+ <function>ibase_query</function>.
</simpara>
</refsect1>
</refentry>
@@ -143,14 +199,19 @@
<refentry id="function.ibase-prepare">
<refnamediv>
<refname>ibase_prepare</refname>
- <refpurpose>Prepare a query for later binding of parameter placeholders and \
execution.</refpurpose> + <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> <parameter><optional>int \
link_identifier</optional></parameter></paramdef>
- <paramdef> <parameter> string query</parameter></paramdef>
+ <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
@@ -163,7 +224,9 @@
<refentry id="function.ibase-bind">
<refnamediv>
<refname>ibase_bind</refname>
- <refpurpose>Bind placeholder parameters from a previously prepared \
query</refpurpose> + <refpurpose>
+ Bind placeholder parameters from a previously prepared query
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -171,11 +234,15 @@
<funcdef> <function>ibase_bind</function></funcdef>
<paramdef> <parameter>int query</parameter></paramdef>
</funcsynopsis>
- <simpara>
- Bind Parameters from a query prepared by <function>ibase_prepare</function>.
- </simpara>
+ <simpara>
+ Bind Parameters from a query prepared by
+ <function>ibase_prepare</function>.
+ </simpara>
<note>
- <para><function>ibase_bind</function> is currently not functional </para>
+ <para>
+ <function>Ibase_bind</function> is currently not functional in
+ PHP4
+ </para>
</note>
</refsect1>
</refentry>
@@ -191,16 +258,20 @@
<funcdef>int <function>ibase_execute</function></funcdef>
<paramdef> <parameter>int query</parameter></paramdef>
</funcsynopsis>
- <simpara>
- Execute a query prepared (and perhaps binded) by <function>ibase_prepare</function> \
and <function>ibase_bind</function>.
- </simpara>
+ <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>
+ <refpurpose>
+ Free memory allocated by a prepared query
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -208,16 +279,18 @@
<funcdef> <function>ibase_free_query</function></funcdef>
<paramdef> <parameter>int query</parameter></paramdef>
</funcsynopsis>
- <simpara>
- Free a query prepared by <function>ibase_prepare</function>.
- </simpara>
+ <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> + <refpurpose>
+ Sets the format of datetime columns returned from queries
+ </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
@@ -225,17 +298,64 @@
<funcdef> <function>ibase_timefmt</function></funcdef>
<paramdef> <parameter>string 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 </para>
+ <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>
- </reference>
+ <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_rows($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_timefmt</function> is currently not functional
+ in PHP4.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ </reference>
<!-- Keep this comment at the end of the file
Local variables:
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic