Skip to content

Commit 9193206

Browse files
committed
[reference/mysqli] sync with en.
1 parent 9e83c65 commit 9193206

16 files changed

+162
-79
lines changed

reference/mysqli/constants.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: e11d90ec66baf31038e800870913ff2baec5ba72 Maintainer: takagi Status: working -->
3+
<!-- EN-Revision: e11d90ec66baf31038e800870913ff2baec5ba72 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,mumumu -->
55
<appendix xml:id="mysqli.constants" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.constants;

reference/mysqli/ini.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: f26734be49cca400204fcf3243271c7ff138823d Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
66
&reftitle.runtime;
@@ -108,7 +108,7 @@
108108
<varlistentry xml:id="ini.mysqli.allow-local-infile">
109109
<term>
110110
<parameter>mysqli.allow_local_infile</parameter>
111-
<type>int</type>
111+
<type>bool</type>
112112
</term>
113113
<listitem>
114114
<para>
@@ -133,7 +133,7 @@
133133
<varlistentry xml:id="ini.mysqli.allow-persistent">
134134
<term>
135135
<parameter>mysqli.allow_persistent</parameter>
136-
<type>int</type>
136+
<type>bool</type>
137137
</term>
138138
<listitem>
139139
<para>

reference/mysqli/mysqli/commit.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 976425d4f6eec32448be3cc22ec063015921b753 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,mumumu -->
55
<refentry xml:id="mysqli.commit" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -38,7 +38,7 @@
3838
<term><parameter>flags</parameter></term>
3939
<listitem>
4040
<para>
41-
定数 <constant>MYSQLI_TRANS_COR_*</constant> のビットマスク。
41+
定数 <constant>MYSQLI_TRANS_COR_<replaceable>*</replaceable></constant> のビットマスク。
4242
</para>
4343
</listitem>
4444
</varlistentry>

reference/mysqli/mysqli/connect-errno.xml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 104bc5c203adbc75f7c71960bb18b2b71c889b45 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: a87dfa33829abeafe3a0bcebdb57e117ebf6017d Maintainer: takagi Status: ready -->
44
<refentry xml:id="mysqli.connect-errno" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
66
<refname>mysqli::$connect_errno</refname>
@@ -33,6 +33,10 @@
3333
直近で試みた接続コールが失敗した場合、
3434
エラーコードを返します。ゼロは、何もエラーが発生しなかったことを示します。
3535
</para>
36+
<para>
37+
この関数をコールしたインスタンスに関係なく、
38+
直近の接続に関するエラーコードを返します。
39+
</para>
3640
</refsect1>
3741

3842
<refsect1 role="examples">

reference/mysqli/mysqli/connect-error.xml

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 104bc5c203adbc75f7c71960bb18b2b71c889b45 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: a87dfa33829abeafe3a0bcebdb57e117ebf6017d Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.connect-error" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -34,6 +34,10 @@
3434
エラーの内容を表す文字列を返します。エラーが発生しなかった場合は
3535
&null; を返します。
3636
</para>
37+
<para>
38+
この関数をコールしたインスタンスに関係なく、
39+
直近の接続に関するエラーコードを返します。
40+
</para>
3741
</refsect1>
3842

3943
<refsect1 role="examples">

reference/mysqli/mysqli/construct.xml

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 9dadf74254fa743db43e73ab3f5a3d441c271ab1 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,mumumu -->
55
<refentry xml:id="mysqli.construct" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -126,6 +126,11 @@
126126

127127
<refsect1 role="returnvalues">
128128
&reftitle.returnvalues;
129+
<para>
130+
<methodname>mysqli::__construct</methodname>
131+
は、接続が成功するかしないかに関係なく、
132+
MySQL サーバへの接続を表すオブジェクトを常に返します。
133+
</para>
129134
<para>
130135
<function>mysqli_connect</function> は、
131136
MySQL サーバーへの接続を表すオブジェクトを返します。

reference/mysqli/mysqli/get-client-info.xml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.get-client-info" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -15,6 +15,7 @@
1515
<para>&style.oop;</para>
1616
<fieldsynopsis><type>string</type><varname linkend="mysqli.get-client-info">mysqli-&gt;client_info</varname></fieldsynopsis>
1717
<methodsynopsis role="mysqli">
18+
<modifier role="attribute">#[\Deprecated]</modifier>
1819
<modifier>public</modifier> <type>string</type><methodname>mysqli::get_client_info</methodname>
1920
<void/>
2021
</methodsynopsis>

reference/mysqli/mysqli/get-warnings.xml

Lines changed: 97 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 2cc28adf4bea27371e03ef0367ea45897cfb6446 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.get-warnings" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -22,7 +22,102 @@
2222
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
2323
</methodsynopsis>
2424

25-
&warn.undocumented.func;
25+
<simpara>
26+
<classname>mysqli_warning</classname>
27+
で構成された単方向リンクリストを返します。
28+
警告がない場合は &false; を返します。
29+
リスト中のオブジェクトはそれぞれ、
30+
<code>SHOW WARNINGS</code> の単一行の結果からなります。
31+
<methodname>mysqli_warning::next</methodname>
32+
をコールすると、次の行からオブジェクトを埋めます。
33+
</simpara>
34+
<note>
35+
<simpara>
36+
警告メッセージを取得するには、
37+
この関数ではなく、SQLコマンド
38+
<literal>SHOW WARNINGS [limit row_count]</literal>
39+
を使うことを推奨します。
40+
</simpara>
41+
</note>
42+
<warning>
43+
<simpara>
44+
リンクリストは、巻き戻したり、再取得したりはできません。
45+
</simpara>
46+
</warning>
47+
</refsect1>
48+
49+
<refsect1 role="parameters">
50+
&reftitle.parameters;
51+
<variablelist>
52+
&mysqli.link.description;
53+
</variablelist>
54+
</refsect1>
55+
56+
<refsect1 role="returnvalues">
57+
&reftitle.returnvalues;
58+
<simpara>
59+
Returns a singly linked list comprised of
60+
<classname>mysqli_warning</classname> or &false; if there are no warnings.
61+
</simpara>
62+
</refsect1>
63+
64+
<refsect1 role="examples">
65+
&reftitle.examples;
66+
<example>
67+
<title>全ての警告を取得するために連結リストを走査する</title>
68+
69+
<para>&style.oop;</para>
70+
<programlisting role="php">
71+
<![CDATA[
72+
<?php
73+
74+
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
75+
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
76+
77+
$mysqli->query("SELECT 1/0, CAST('NULL' AS UNSIGNED)");
78+
79+
if ($mysqli->warning_count > 0) {
80+
$warning = $mysqli->get_warnings();
81+
if ($warning !== false) {
82+
do {
83+
printf("Error number: %s\n", $warning->errno);
84+
printf("Message: %s\n", $warning->message);
85+
} while ($warning->next());
86+
}
87+
}
88+
]]>
89+
</programlisting>
90+
<para>&style.procedural;</para>
91+
<programlisting role="php">
92+
<![CDATA[
93+
<?php
94+
95+
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
96+
$link = mysqli_connect("localhost", "user", "password", "test");
97+
98+
mysqli_query($link, "SELECT 1/0, CAST('NULL' AS UNSIGNED)");
99+
100+
if (mysqli_warning_count($link) > 0) {
101+
$warning = mysqli_get_warnings($link);
102+
if ($warning !== false) {
103+
do {
104+
printf("Error number: %s\n", $warning->errno);
105+
printf("Message: %s\n", $warning->message);
106+
} while ($warning->next());
107+
}
108+
}
109+
]]>
110+
</programlisting>
111+
&examples.outputs;
112+
<screen>
113+
<![CDATA[
114+
Error number: 1365
115+
Message: Division by 0
116+
Error number: 1292
117+
Message: Truncated incorrect INTEGER value: 'NULL'
118+
]]>
119+
</screen>
120+
</example>
26121
</refsect1>
27122

28123
</refentry>

reference/mysqli/mysqli/init.xml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mumumu Status: ready -->
44

55
<refentry xml:id="mysqli.init" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -13,6 +13,7 @@
1313
&reftitle.description;
1414
<para>&style.oop;</para>
1515
<methodsynopsis role="mysqli">
16+
<modifier role="attribute">#[\Deprecated]</modifier>
1617
<modifier>public</modifier> <type class="union"><type>bool</type><type>null</type></type><methodname>mysqli::init</methodname>
1718
<void/>
1819
</methodsynopsis>

reference/mysqli/mysqli/kill.xml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="mysqli.kill" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -17,11 +17,13 @@
1717
&reftitle.description;
1818
<para>&style.oop;</para>
1919
<methodsynopsis role="mysqli">
20+
<modifier role="attribute">#[\Deprecated]</modifier>
2021
<modifier>public</modifier> <type>bool</type><methodname>mysqli::kill</methodname>
2122
<methodparam><type>int</type><parameter>process_id</parameter></methodparam>
2223
</methodsynopsis>
2324
<para>&style.procedural;</para>
2425
<methodsynopsis>
26+
<modifier role="attribute">#[\Deprecated]</modifier>
2527
<type>bool</type><methodname>mysqli_kill</methodname>
2628
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
2729
<methodparam><type>int</type><parameter>process_id</parameter></methodparam>

0 commit comments

Comments
 (0)