Php/docs/mysqli-result.fetch-object

From Get docs

mysqli_result::fetch_object

mysqli_fetch_object

(PHP 5, PHP 7)

mysqli_result::fetch_object -- mysqli_fetch_objectReturns the current row of a result set as an object


Description

Object oriented style

public mysqli_result::fetch_object ([ string $class_name = "stdClass" [, array $params ]] ) : object

Procedural style

mysqli_fetch_object ( mysqli_result $result [, string $class_name = "stdClass" [, array $params ]] ) : object

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.

Note that mysqli_fetch_object() sets the properties of the object before calling the object constructor.


Parameters

result
Procedural style only: A result set identifier returned by mysqli_query(), mysqli_store_result() or mysqli_use_result().
class_name
The name of the class to instantiate, set the properties of and return. If not specified, a stdClass object is returned.
params
An optional array of parameters to pass to the constructor for class_name objects.


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.

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 examples will output:


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

See Also