-
Notifications
You must be signed in to change notification settings - Fork 82
Expand file tree
/
Copy pathenableExceptions.xml
More file actions
131 lines (124 loc) · 3.89 KB
/
enableExceptions.xml
File metadata and controls
131 lines (124 loc) · 3.89 KB
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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cf116cb470d5d2728fda0356ad835c2f6f1b7327 Maintainer: mumumu Status: ready -->
<refentry xml:id="sqlite3.enableexceptions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SQLite3::enableExceptions</refname>
<refpurpose>
例外のスローを有効にする
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SQLite3">
<modifier>public</modifier> <type>bool</type><methodname>SQLite3::enableExceptions</methodname>
<methodparam choice="opt"><type>bool</type><parameter>enable</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
<classname>SQLite3</classname> が、エラー時に警告や例外をスローするかどうかを制御します。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
&true; の場合、
<classname>SQLite3</classname> のインスタンスと、
<classname>SQLite3Stmt</classname> および <classname>SQLite3Result</classname>
から派生したインスタンスは、エラー時に例外をスローします
</para>
<para>
&false; の場合、
<classname>SQLite3</classname> のインスタンスと、
<classname>SQLite3Stmt</classname> および <classname>SQLite3Result</classname>
から派生したインスタンスは、エラー時に警告を発生させます。
</para>
<para>
どちらのモードであっても、エラーコードやメッセージがもしあれば、
<methodname>SQLite3::lastErrorCode</methodname> と
<methodname>SQLite3::lastErrorMsg</methodname> で利用できます。
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
古い値を返します。つまり、例外が有効であったなら &true; そうでなければ &false; を返します。
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.3.0</entry>
<entry>
<parameter>enable</parameter> を &false; にして
<methodname>SQLite3::enableExceptions</methodname>
をコールすると、<constant>E_DEPRECATED</constant> が発生するようになりました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example xml:id="sqlite3.enableexceptions.example.basic">
<title><methodname>SQLite3::enableExceptions</methodname> の例</title>
<programlisting role="php">
<![CDATA[
<?php
$sqlite = new SQLite3(':memory:');
try {
$sqlite->exec('create table foo');
$sqlite->enableExceptions(true);
$sqlite->exec('create table bar');
} catch (Exception $e) {
echo 'Caught exception: ' . $e->getMessage();
}
?>
]]>
</programlisting>
&example.outputs.similar;
<screen role="php">
<![CDATA[
Warning: SQLite3::exec(): near "foo": syntax error in example.php on line 4
Caught exception: near "bar": syntax error
]]>
</screen>
</example>
</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:"~/.phpdoc/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
-->