mysqli_result::fetch_fields
mysqli_result::fetch_row
MySQLi_Result
PHP Manual

# mysqli_result::fetch_object

# mysqli_fetch_object

(PHP 5)

mysqli_fetch_object — Returns the current row of a result set as an object

### Description

Object oriented style (method):

object mysqli_result::fetch_object ([ string `$class_name` [, array `$params` ]] )

Procedural style:

object mysqli_fetch_object ( mysqli_result `$result` [, string `$class_name` [, array `$params` ]] )

The mysqli_fetch_object() will return the current row result set as an object where the attributes of the object represent the names of the fields found within the result set.

### Parameters

`result`

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

`class_name`

`params`

### Return Values

Returns an object with string properties that corresponds to the fetched row or `NULL` if there are no more rows in resultset.

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

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

### ChangeLog

Version | Description
--- | ---
5.0.0 | Added the ability to return as a different object.

### Examples

Example#1 Object oriented style

`<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";
if ($result = $mysqli->query($query)) {
/* fetch object array */
while ($obj = $result->fetch_object()) {
printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
}
/* free result set */
$result->close();
}
/* close connection */
$mysqli->close();
?>`

Example#2 Procedural style

`<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* check connection */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";
if ($result = mysqli_query($link, $query)) {
/* fetch associative array */
while ($obj = mysqli_fetch_object($result)) {
printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
}
/* free result set */
mysqli_free_result($result);
}
/* close connection */
mysqli_close($link);
?>`

The above example will output:

    Pueblo (USA)
    Arvada (USA)
    Cape Coral (USA)
    Green Bay (USA)
    Santa Clara (USA)

### See Also

- mysqli_fetch_array()
- mysqli_fetch_assoc()
- mysqli_fetch_row()
- mysqli_query()
- mysqli_data_seek()

mysqli_result::fetch_fields
mysqli_result::fetch_row
MySQLi_Result
PHP Manual