mysql_fetch_lengths
mysql_fetch_row
Funções da MySQL
PHP Manual

# mysql_fetch_object

(PHP 4, PHP 5)

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 resultado 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

Exemplo #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);
?>`

Exemplo #2 Exemplo mysql_fetch_object()

`<?php
class foo {
public $name;
}
mysql_connect("hostname", "user", "password");
mysql_select_db("mydb");
$result = mysql_query("select name from mytable limit 1");
$obj = mysql_fetch_object($result, 'foo');
var_dump($obj);
?>`

### 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.

### Veja Também

- mysql_fetch_array() - Obtém uma linha como uma matriz associativa, uma matriz numérica, ou ambas
- mysql_fetch_assoc() - Obtém um linha do resultado como uma matriz associativa
- mysql_fetch_row() - Obtém uma linha como uma array numérica
- mysql_data_seek() - Move o ponteiro interno do resultado
- mysql_query() - Envia uma consulta MySQL

mysql_fetch_lengths
mysql_fetch_row
Funções da MySQL
PHP Manual