PHP Manual
Prev |  | Next

# mysql_fetch_array

(PHP 3, PHP 4, PHP 5)

mysql_fetch_array -- Fetch a result row as an associative array, a numeric array, or both

## Description

array mysql_fetch_array ( resource result [, int result_type] )

Returns an array that corresponds to the fetched row and moves the internal data pointer ahead.

## Parameters

result

  The result resource that is being evaluated. This result comes from a call to mysql_query().

result_type

  The type of array that is to be fetched. It's a constant and can take the following values: `MYSQL_ASSOC`, `MYSQL_NUM`, and the default value of `MYSQL_BOTH`.

## Return Values

Returns an array that corresponds to the fetched row, or `FALSE` if there are no more rows. The type of returned array depends on how result_type is defined. By using `MYSQL_BOTH` (default), you'll get an array with both associative and number indices. Using `MYSQL_ASSOC`, you only get associative indices (as mysql_fetch_assoc() works), using `MYSQL_NUM`, you only get number indices (as mysql_fetch_row() works).

If two or more columns of the result have the same field names, the last column will take precedence. To access the other column(s) of the same name, you must use the numeric index of the column or make an alias for the column. For aliased columns, you cannot access the contents with the original column name.

## Examples

Example 1. Query with aliased duplicate field names
    SELECT table1.field AS foo, table2.field AS bar FROM table1, table2

Example 2. mysql_fetch_array() with `MYSQL_NUM`
`<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Could not connect: " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_NUM)) { printf("ID: %s Name: %s", $row[0], $row[1]); } mysql_free_result($result); ?>`

Example 3. mysql_fetch_array() with `MYSQL_ASSOC`
`<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Could not connect: " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) { printf("ID: %s Name: %s", $row["id"], $row["name"]); } mysql_free_result($result); ?>`

Example 4. mysql_fetch_array() with `MYSQL_BOTH`
`<?php mysql_connect("localhost", "mysql_user", "mysql_password") or die("Could not connect: " . mysql_error()); mysql_select_db("mydb"); $result = mysql_query("SELECT id, name FROM mytable"); while ($row = mysql_fetch_array($result, MYSQL_BOTH)) { printf ("ID: %s Name: %s", $row[0], $row["name"]); } mysql_free_result($result); ?>`

## Notes

> Performance: An important thing to note is that using mysql_fetch_array() is not significantly slower than using mysql_fetch_row(), while it provides a significant added value.

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

> Note: This function sets NULL fields to PHP `NULL` value.

## See Also

mysql_fetch_row()
mysql_fetch_assoc()
mysql_data_seek()
mysql_query()

Prev | Home | Next
mysql_escape_string | Up | mysql_fetch_assoc