mysqli_result::fetch_array

mysqli_fetch_array

(PHP 5, PHP 7)

mysqli_result::fetch_array -- mysqli_fetch_arrayFetch a result row as an associative, a numeric array, or both

Description

Object oriented style

public mysqli_result::fetch_array ( int $mode = MYSQLI_BOTH ) : array|null|false

Procedural style

mysqli_fetch_array ( mysqli_result $result , int $mode = MYSQLI_BOTH ) : array|null|false

Returns an array that corresponds to the fetched row or null if there are no more rows for the result set.

In addition to storing the data in the numeric indices of the result array, this function can also store the data in associative indices by using the field names of the result set as keys.

Note: Field names returned by this function are case-sensitive.

Note: This function sets NULL fields to the PHP null value.

If two or more columns of the result have the same field names, the last column will take precedence and overwrite the earlier data. In order to access multiple columns with the same name, the numerically indexed version of the row must be used.

Parameters

result

Procedural style only: A result set identifier returned by mysqli_query(), mysqli_store_result() or mysqli_use_result().

mode

This optional parameter is a constant indicating what type of array should be produced from the current row data. The possible values for this parameter are the constants MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH.

By using the MYSQLI_ASSOC constant this function will behave identically to the mysqli_fetch_assoc(), while MYSQLI_NUM will behave identically to the mysqli_fetch_row() function. The final option MYSQLI_BOTH will create a single array with the attributes of both.

Return Values

Returns an array of values that corresponds to the fetched row or null if there are no more rows in result set.

Examples

Example #1 mysqli_result::fetch_array() example

Object oriented style

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost""my_user""my_password""world");

$query "SELECT Name, CountryCode FROM City ORDER BY ID LIMIT 3";
$result $mysqli->query($query);

/* numeric array */
$row $result->fetch_array(MYSQLI_NUM);
printf("%s (%s)\n"$row[0], $row[1]);

/* associative array */
$row $result->fetch_array(MYSQLI_ASSOC);
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);

/* associative and numeric array */
$row $result->fetch_array(MYSQLI_BOTH);
printf("%s (%s)\n"$row[0], $row["CountryCode"]);

Procedural style

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli mysqli_connect("localhost""my_user""my_password""world");

$query "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3";
$result mysqli_query($mysqli$query);

/* numeric array */
$row mysqli_fetch_array($resultMYSQLI_NUM);
printf("%s (%s)\n"$row[0], $row[1]);

/* associative array */
$row mysqli_fetch_array($resultMYSQLI_ASSOC);
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);

/* associative and numeric array */
$row mysqli_fetch_array($resultMYSQLI_BOTH);
printf("%s (%s)\n"$row[0], $row["CountryCode"]);

The above examples will output something similar to:

Kabul (AFG)
Qandahar (AFG)
Herat (AFG)

See Also