Debian Codegraph @

doc/programmers-guide/connerrors.html

raw
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Connection error numbers and messages</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Database Independent Abstraction Layer for C"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="Error Handling"
14 HREF="errorhandling.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Error Handling"
17 HREF="errorhandling.html"><LINK
18 REL="NEXT"
19 TITLE="Error numbers"
20 HREF="errornumbers.html"></HEAD
21 ><BODY
22 CLASS="SECT1"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >Database Independent Abstraction Layer for C: libdbi Programmer's Guide</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="errorhandling.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 4. Error Handling</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="errornumbers.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECT1"
73 ><H1
74 CLASS="SECT1"
75 ><A
76 NAME="CONNERRORS"
77 >4.1. Connection error numbers and messages</A
78 ></H1
79 ><P
80 >If your application has successfully opened a connection to a database, all operations on this connection may cause errors. There are two classes of errors:</P
81 ><P
82 ></P
83 ><DIV
84 CLASS="VARIABLELIST"
85 ><DL
86 ><DT
87 >Client library errors</DT
88 ><DD
89 ><P
90 >libdbi retrieves and stores the error codes of the database engine client library if it provides error codes in a suitable format. If the client library does not support error numbers as positive integers, the value DBI_ERROR_CLIENT indicates an error status instead. In addition a string may be provided which describes or further elaborates the error status. The possible values of error number and error message depend on the database engine used for the connection.</P
91 ></DD
92 ><DT
93 >libdbi errors</DT
94 ><DD
95 ><P
96 >A number of errors may occur within the libdbi framework or within a database driver, e.g. if your program queries nonexistent columns or attempts to read past the last row of a result set. The possible error numbers and error messages are predefined by libdbi.</P
97 ></DD
98 ></DL
99 ></DIV
100 ><P
101 >Use the function <A
102 HREF="reference-conn.html#DBI-CONN-ERROR"
103 >dbi_conn_error</A
104 > to access the error number and error message of the most recent connection operation.</P
105 ></DIV
106 ><DIV
107 CLASS="NAVFOOTER"
108 ><HR
109 ALIGN="LEFT"
110 WIDTH="100%"><TABLE
111 SUMMARY="Footer navigation table"
112 WIDTH="100%"
113 BORDER="0"
114 CELLPADDING="0"
115 CELLSPACING="0"
116 ><TR
117 ><TD
118 WIDTH="33%"
119 ALIGN="left"
120 VALIGN="top"
121 ><A
122 HREF="errorhandling.html"
123 ACCESSKEY="P"
124 >Prev</A
125 ></TD
126 ><TD
127 WIDTH="34%"
128 ALIGN="center"
129 VALIGN="top"
130 ><A
131 HREF="index.html"
132 ACCESSKEY="H"
133 >Home</A
134 ></TD
135 ><TD
136 WIDTH="33%"
137 ALIGN="right"
138 VALIGN="top"
139 ><A
140 HREF="errornumbers.html"
141 ACCESSKEY="N"
142 >Next</A
143 ></TD
144 ></TR
145 ><TR
146 ><TD
147 WIDTH="33%"
148 ALIGN="left"
149 VALIGN="top"
150 >Error Handling</TD
151 ><TD
152 WIDTH="34%"
153 ALIGN="center"
154 VALIGN="top"
155 ><A
156 HREF="errorhandling.html"
157 ACCESSKEY="U"
158 >Up</A
159 ></TD
160 ><TD
161 WIDTH="33%"
162 ALIGN="right"
163 VALIGN="top"
164 >Error numbers</TD
165 ></TR
166 ></TABLE
167 ></DIV
168 ></BODY
169 ></HTML
170 >