Forum und email

mysql_fetch_object

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_fetch_object — Obtém o resultado de uma linha como um objeto

Descrição

object mysql_fetch_object ( resource $result [, string $class_name [, array $params ]] )

Retorna um objeto com propriedades que correspondem a linha obtida e move o ponteiro interno dos dados adiante.

Parâmetros

result

O resulatado resource que esta sendo avaliado. Este resultado vem de uma chamada a mysql_query().

class_name

O nome de classe para instanciar, definir as propriedades e retornar. Se não for especificado, um objeto stdClass é retornado.

params

Uma array opcional de parâmetros para passar para o construtor do objeto class_name .

Valor Retornado

Retorna um object com propriedades strings que correspondem a linha obtida, ou FALSE se não houverem mais linhas.

mysql_fetch_row() obtém uma linha de dados do resultado associado ao identificador de resultados dado. A linha é retornada como um array. Cada coluna do resultado é guardada em um índice da matriz, começando no índice 0.

Histórico

Versão Descrição
5.0.0 Adiciona a abilidade de retornar como um objeto diferente.

Exemplos

Example#1 Exemplo mysql_fetch_object()

<?php
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 Exemplo mysql_fetch_object()

<?php

$row 
mysql_fetch_object($result);

/* isto é valido */
echo $row->field;
/* isto não é valido */
// echo $row->0;

?>

Notas

Nota: Performance Em termos de velocidade, a função é identica a mysql_fetch_array(), e quase tão rápida quanto mysql_fetch_row() (a diferença é insignificante).

Nota: mysql_fetch_object() é similar a mysql_fetch_array(), com uma diferença - um objeto é retornado, ao invés de um array. Indiretamente, isto significa que você pode acessar os dados apenas pelo nome dos campos, e não por seus índices (numeros são ilegais como nomes de propriedades).

Nota: Nomes de campos nesta função diferenciam maiúsculas e minusculas.

Nota: Esta função assimila campos NULL para o o NULL do PHP.