reference/mysqli/mysqli_stmt/construct.xml
63b99082ef83eade08151f8cb528246fded81db9
63b99082ef83eade08151f8cb528246fded81db9
...
...
@@ -1,6 +1,5 @@
1
1
<?xml version="1.0" encoding="utf-8"?>
2
2
<!-- $Revision$ -->
3
-
4
3
<refentry xml:id="mysqli-stmt.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5
4
<refnamediv>
6
5
<refname>mysqli_stmt::__construct</refname>
...
...
@@ -9,39 +8,35 @@
9
8
10
9
<refsect1 role="description">
11
10
&reftitle.description;
12
-
<constructorsynopsis>
13
-
<methodname>mysqli_stmt::__construct</methodname>
14
-
<methodparam><type>mysqli</type><parameter>link</parameter></methodparam>
15
-
<methodparam choice="opt"><type>string</type><parameter>query</parameter></methodparam>
11
+
<constructorsynopsis role="mysqli_stmt">
12
+
<modifier>public</modifier> <methodname>mysqli_stmt::__construct</methodname>
13
+
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
14
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>query</parameter><initializer>&null;</initializer></methodparam>
16
15
</constructorsynopsis>
17
16
<para>
18
17
This method constructs a new <classname>mysqli_stmt</classname> object.
19
18
</para>
20
-
<note>
21
-
<para>
22
-
In general, you should use either <function>mysqli_prepare</function> or
23
-
<function>mysqli_stmt_init</function> to create a
24
-
<classname>mysqli_stmt</classname> object, rather than directly
25
-
instantiating the object with <literal>new mysqli_stmt</literal>. This
26
-
method (and the ability to directly instantiate
27
-
<classname>mysqli_stmt</classname> objects) may be deprecated and removed
28
-
in the future.
29
-
</para>
30
-
</note>
31
19
</refsect1>
32
20
33
21
<refsect1 role="parameters">
34
22
&reftitle.parameters;
35
23
<para>
36
24
<variablelist>
37
-
&mysqli.link.description;
25
+
<varlistentry>
26
+
<term><parameter>link</parameter></term>
27
+
<listitem>
28
+
<para>
29
+
A valid <classname>mysqli</classname> object.
30
+
</para>
31
+
</listitem>
32
+
</varlistentry>
38
33
<varlistentry>
39
34
<term><parameter>query</parameter></term>
40
35
<listitem>
41
36
<para>
42
-
The query, as a string. If this parameter is omitted, then the
37
+
The query, as a string. If this parameter is &null;, then the
43
38
constructor behaves identically to
44
-
<function>mysqli_stmt_init</function>, if provided, then it behaves as
39
+
<function>mysqli_stmt_init</function>, otherwise it behaves as
45
40
per <function>mysqli_prepare</function>.
46
41
</para>
47
42
</listitem>
...
...
@@ -50,6 +45,33 @@
50
45
</para>
51
46
</refsect1>
52
47
48
+
<refsect1 role="errors">
49
+
&reftitle.errors;
50
+
&mysqli.conditionalexception;
51
+
</refsect1>
52
+
53
+
<refsect1 role="changelog">
54
+
&reftitle.changelog;
55
+
<informaltable>
56
+
<tgroup cols="2">
57
+
<thead>
58
+
<row>
59
+
<entry>&Version;</entry>
60
+
<entry>&Description;</entry>
61
+
</row>
62
+
</thead>
63
+
<tbody>
64
+
<row>
65
+
<entry>8.0.0</entry>
66
+
<entry>
67
+
<parameter>query</parameter> is now nullable.
68
+
</entry>
69
+
</row>
70
+
</tbody>
71
+
</tgroup>
72
+
</informaltable>
73
+
</refsect1>
74
+
53
75
<refsect1 role="seealso">
54
76
&reftitle.seealso;
55
77
<para>
...
...
@@ -60,7 +82,6 @@
60
82
</para>
61
83
</refsect1>
62
84
</refentry>
63
-
64
85
<!-- Keep this comment at the end of the file
65
86
Local variables:
66
87
mode: sgml
67
88