cvs: phpdoc-ru /reference/oci8/functions oci-error.xml
| From: | Antony Dovgal | Date: | Mon, 24 May 2004 07:17:03 +0000 |
| Subject: | cvs: phpdoc-ru /reference/oci8/functions oci-error.xml | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-346@lists.php.net to get a copy of this message | ||
tony2001 Mon May 24 03:17:03 2004 EDT
Modified files:
/phpdoc-ru/reference/oci8/functions oci-error.xml
Log:
sync with EN (add examples and changes proposed by Christopher)
http://cvs.php.net/diff.php/phpdoc-ru/reference/oci8/functions/oci-error.xml?r1=1.2&r2=1.3&ty=u
Index: phpdoc-ru/reference/oci8/functions/oci-error.xml
diff -u phpdoc-ru/reference/oci8/functions/oci-error.xml:1.2
phpdoc-ru/reference/oci8/functions/oci-error.xml:1.3
--- phpdoc-ru/reference/oci8/functions/oci-error.xml:1.2 Thu Apr 1 03:12:21 2004
+++ phpdoc-ru/reference/oci8/functions/oci-error.xml Mon May 24 03:17:02 2004
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="windows-1251"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<refentry id="function.oci-error">
<refnamediv>
<refname>oci_error</refname>
@@ -12,12 +12,13 @@
<methodparam
choice="opt"><type>resource</type><parameter>source</parameter></methodparam>
</methodsynopsis>
<para>
- <function>oci_error</function> âîçâðàùàåò ïîñëåäíþþ
îøèáêó, êîòîðàÿ áûëà
- îáíàðóæåíà â óêàçàííîì ðåñóðñå.  êà÷åñòâå
<parameter>source</parameter>
- ìîãóò áûòü èñïîëüçîâàíû èäåíòèôèêàòîðû ñîåäèíåíèÿ
è SQL-âûðàæåíèé.
- Åñëè ïàðàìåòð <parameter>source</parameter> íå áûë óêàçàí,
òî
- âîçâðàùàåòñÿ ñàìàÿ ïîñëåäíÿÿ íàéäåííàÿ îøèáêà. Â
ñëó÷àå, åñëè îøèáîê
- íå áûëî íàéäåíî, <function>oci_error</function> âîçâðàùàåò
&false;.
+ Äëÿ áîëüøèíñòâà îøèáîê ïàðàìåòðîì
<parameter>source</parameter> ÿâëÿåòñÿ
+ ñîîòâåòñòâóþùèé èäåíòèôèêàòîð ñîåäèíåíèÿ èëè
âûðàæåíèÿ. Äëÿ îøèáîê âî âðåìÿ
+ âûïîëíåíèÿ ôóíêöèé <function>oci_connect</function>,
+ <function>oci_new_connect</function> è
<function>oci_pconnect</function>
+ ýòîò ïàðàìåòð óêàçûâàòü íå ñëåäóåò.
<function>oci_error</function> âîçâðàùàåò
+ ïîñëåäíþþ îøèáêó, êîòîðàÿ áûëà îáíàðóæåíà â
óêàçàííîì ðåñóðñå.  ñëó÷àå,
+ åñëè îøèáîê íå áûëî íàéäåíî, <function>oci_error</function>
âîçâðàùàåò &false;.
</para>
<para>
<function>oci_error</function> âîçâðàùàåò îøèáêó â âèäå
àññîöèàòèâíîãî
@@ -33,6 +34,52 @@
áûëè äîáàâëåíû íà÷èíàÿ ñ âåðñèè PHP 4.3.
</simpara>
</note>
+ <para>
+ <example>
+ <title>Âûâîä ñîîáùåíèÿ ïðè îøèáêå
ñîåäèíåíèÿ</title>
+ <programlisting role="php">
+<![CDATA[
+$conn = @oci_connect("scott", "tiger", "mydb");
+if (!$conn) {
+ $e = oci_error(); // For oci_connect errors pass no handle
+ echo htmlentities($e['message']);
+}
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Âûâîä ñîîáùåíèÿ ïðè îøèáêå ïàðñèíãà
âûðàæåíèÿ</title>
+ <programlisting role="php">
+<![CDATA[
+$stmt = @oci_parse($conn, "select ' from dual"); // note mismatched quote
+if (!$stmt) {
+ $e = oci_parse($conn); // For oci_parse errors pass the connection handle
+ echo htmlentities($e['message']);
+}
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ <example>
+ <title>Âûâîä ñîîáùåíèÿ îá îøèáêå è SQL-âûðàæåíèÿ, â
êîòîðîì îíà âîçíèêëà</title>
+ <programlisting role="php">
+<![CDATA[
+$r = oci_execute($stmt);
+if (!$r) {
+ $e = oci_error($stmt); // For oci_execute errors pass the statementhandle
+ echo htmlentities($e['message']);
+ echo "<pre>";
+ echo htmlentities($e['sqltext']);
+ printf("\n%".($e['offset']+1)."s", "^");
+ echo "</pre>";
+}
+]]>
+ </programlisting>
+ </example>
+ </para>
<note>
<para>
 âåðñèÿõ PHP íèæå 5.0.0 ýòà ôóíêöèÿ íàçûâàëàñü
<function>ocierror</function>.