Copyright 1997-2012 the PHP Documentation Group.
mysqli_result::fetch_object
mysqli_fetch_object
Returns the current row of a result set as an object
Description
Object oriented style
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.
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.
Field names returned by this function are case-sensitive.
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 3.121. 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 3.122. 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
mysqli_fetch_array
|
mysqli_fetch_assoc
|
mysqli_fetch_row
|
mysqli_query
|
mysqli_data_seek
|

User Comments
Add your own comment.