PHP mysql_fetch_object function

Like this blog? Consider exploring one of our sponsored banner ads...

mysql_fetch_object

(PHP 3, PHP 4, PHP 5)

mysql_fetch_object — Fetch a result row as an objectDescriptionobject mysql_fetch_object ( resource result [, string class_name [, array params]] )

Returns an object with properties that correspond 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().

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 properties that correspond to the
fetched row, or FALSE if there are no more rows.

mysql_fetch_row() fetches one row of data from
the result associated with the specified result identifier. The
row is returned as an array. Each result column is stored in an
array offset, starting at offset 0.

ChangeLog

VersionDescription5.0.0 Added the ability to return as a different object.


Examples

Example 1. mysql_fetch_object() example

mysql_connect("hostname", "user", "password");
mysql_select_db("mydb");
$result = mysql_query("select * from mytable");
while ($row = mysql_fetch_object($result)) {
    echo $row->user_id;
    echo $row->fullname;
}
mysql_free_result($result);

Example 2. mysql_fetch_object() example

 
$row = mysql_fetch_object($result);
 
/* this is valid */
echo $row->field;
/* this is invalid */
// echo $row->0;

Notes

Performance:
Speed-wise, the function is identical to
mysql_fetch_array(), and almost as quick as
mysql_fetch_row() (the difference is
insignificant).

Note:
mysql_fetch_object() is similar to
mysql_fetch_array(), with one difference – an
object is returned, instead of an array. Indirectly, that means
that you can only access the data by the field names, and not by
their offsets (numbers are illegal property names).

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

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

See Also

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



About this entry