array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli-result.fetch-object.php', 1 => 'mysqli_result::fetch_object', ), 'up' => array ( 0 => 'class.mysqli-result.php', 1 => 'mysqli_result', ), 'prev' => array ( 0 => 'mysqli-result.fetch-fields.php', 1 => 'mysqli_result::fetch_fields', ), 'next' => array ( 0 => 'mysqli-result.fetch-row.php', 1 => 'mysqli_result::fetch_row', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysqli/mysqli_result/fetch-object.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8)
mysqli_result::fetch_object -- mysqli_fetch_object — Recebe a próxima linha de um resultado como um objeto
Estilo orientado a objetos
$class
= "stdClass", array $constructor_args
= []): object|null|falseEstilo procedural
$result
, string $class
= "stdClass", array $constructor_args
= []): object|null|false
Recebe uma linha de dados do resultado e retorna-a como um objeto,
onde cada propriedade representa o nome da coluna do resultado.
Cada chamada subsequente a esta função retornará a linha seguinte dentro
do conjunto de resultados, ou null
se não houver mais linhas.
Se duas ou mais colunas do resultado tiverem o mesmo nome, a última coluna terá precedência e irá sobrescrever os dados anteriores. Para acessar múltiplas colunas com o mesmo nome, mysqli_fetch_row() pode ser usada para receber o array indexado numericamente, ou apelidos podem ser usados na lista de seleção da consulta SQL para dar nomes diferentes às colunas.
Nota: Esta função define as propriedades do objeto antes de chamar o construtor do objeto.
Nota: Os nomes de campos retornados por esta função diferenciam maiúsculas e minúsculas.
Nota: Esta função define campos NULL como o valor
null
do PHP.
result
Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().
class
O nome da classe a instanciar, definir propriedades e retornar. Se não especificada, um objeto stdClass é retornado.
constructor_args
Um array opcional de parâmetros para passar ao construtor
de objetos da classe definida em class
.
Retorna um objeto que representa a linha recebida, onde cada propriedade
representa o nome da coluna do resultado, null
se não
houver mais colunas no resultado, ou false
em caso de falha.
Um exceção ValueError é lançada quando
o parâmetro constructor_args
é não vazio com a classe não possuindo construtor.
Versão | Descrição |
---|---|
8.3.0 |
Agora lança uma exceção ValueError quando
o parâmetro constructor_args é não vazio com a classe não possuindo construtor;
anteriormente uma Exception era lançada.
|
8.0.0 |
constructor_args agora aceita [] para construtores sem parâmetros;
anteriormente, uma exceção era lançada.
|
Exemplo #1 Exemplo de mysqli_result::fetch_object()
Estilo orientado a objetos
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";
$result = $mysqli->query($query);
while ($obj = $result->fetch_object()) {
printf("%s (%s)\n", $obj->Name, $obj->CountryCode);
}
Estilo procedural
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
$query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";
$result = mysqli_query($link, $query);
while ($obj = mysqli_fetch_object($result)) {
printf("%s (%s)\n", $obj->Name, $obj->CountryCode);
}
Os exemplos acima produzirão algo semelhante a:
Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA)