reference/mysqli/mysqli_result/fetch-array.xml
035c126c0393fe154bac46e2c3c489ebadce48a5
...
...
@@ -4,39 +4,40 @@
4
4
<refnamediv>
5
5
<refname>mysqli_result::fetch_array</refname>
6
6
<refname>mysqli_fetch_array</refname>
7
-
<refpurpose>Fetch a result row as an associative, a numeric array, or both</refpurpose>
7
+
<refpurpose>Fetch the next row of a result set as an associative, a numeric array, or both</refpurpose>
8
8
</refnamediv>
9
9

10
10
<refsect1 role="description">
11
11
&reftitle.description;
12
12
<para>&style.oop;</para>
13
-
<methodsynopsis role="oop">
13
+
<methodsynopsis role="mysqli_result">
14
14
<modifier>public</modifier> <type class="union"><type>array</type><type>null</type><type>false</type></type><methodname>mysqli_result::fetch_array</methodname>
15
15
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>MYSQLI_BOTH</constant></initializer></methodparam>
16
16
</methodsynopsis>
17
17
<para>&style.procedural;</para>
18
-
<methodsynopsis role="procedural">
18
+
<methodsynopsis>
19
19
<type class="union"><type>array</type><type>null</type><type>false</type></type><methodname>mysqli_fetch_array</methodname>
20
20
<methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam>
21
21
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer><constant>MYSQLI_BOTH</constant></initializer></methodparam>
22
22
</methodsynopsis>
23
23
<para>
24
-
Returns an array that corresponds to the fetched row or &null; if there
25
-
are no more rows for the result set.
24
+
Fetches one row of data from the result set and returns it as an array.
25
+
Each subsequent call to this function will return the next row within the
26
+
result set, or &null; if there are no more rows.
26
27
</para>
27
28
<para>
28
29
In addition to storing the data in the numeric indices of the result array,
29
30
this function can also store the data in associative indices
30
31
by using the field names of the result set as keys.
31
32
</para>
32
-
&database.field-case;
33
-
&database.fetch-null;
34
33
<para>
35
-
If two or more columns of the result have the same field names, the last
36
-
column will take precedence and overwrite the earlier data. In order to
34
+
If two or more columns of the result have the same name, the last
35
+
column will take precedence and overwrite any previous data. To
37
36
access multiple columns with the same name, the numerically indexed
38
37
version of the row must be used.
39
38
</para>
39
+
&database.field-case;
40
+
&database.fetch-null;
40
41
</refsect1>
41
42

42
43
<refsect1 role="parameters">
...
...
@@ -70,8 +71,8 @@
70
71
<refsect1 role="returnvalues">
71
72
&reftitle.returnvalues;
72
73
<para>
73
-
Returns an array of values that corresponds to the fetched row or &null; if there
74
-
are no more rows in result set.
74
+
Returns an array representing the fetched row, &null; if there
75
+
are no more rows in the result set, &return.falseforfailure;.
75
76
</para>
76
77
</refsect1>
77
78

...
...
@@ -143,6 +144,7 @@ Herat (AFG)
143
144
<para>
144
145
<simplelist>
145
146
<member><function>mysqli_fetch_assoc</function></member>
147
+
<member><function>mysqli_fetch_column</function></member>
146
148
<member><function>mysqli_fetch_row</function></member>
147
149
<member><function>mysqli_fetch_object</function></member>
148
150
<member><function>mysqli_query</function></member>
149
151