array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'mysqli-stmt.store-result.php', 1 => 'mysqli_stmt::store_result', ), 'up' => array ( 0 => 'class.mysqli-stmt.php', 1 => 'mysqli_stmt', ), 'prev' => array ( 0 => 'mysqli-stmt.sqlstate.php', 1 => 'mysqli_stmt::$sqlstate', ), 'next' => array ( 0 => 'class.mysqli-result.php', 1 => 'mysqli_result', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/mysqli/mysqli_stmt/store-result.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5, PHP 7, PHP 8)
mysqli_stmt::store_result -- mysqli_stmt_store_result — Armazena um conjunto de resultados em um buffer interno
Estilo orientado a objetos
Estilo procedural
Esta função deve ser chamada, para consultas que produzem com sucesso
um conjunto de resultados (ex.: SELECT, SHOW, DESCRIBE, EXPLAIN
),
seomente se o resultado completo precisa ser mantido em buffer no PHP. Cada chamada subsequente a
mysqli_stmt_fetch() retornará dados em buffer.
Nota:
É desnecessário chamar mysqli_stmt_store_result() para outras conultas, mas se isto for feito, não irá causar dano ou qualquer perda notável de desempenho em qualquer caso. Pode-se detectar se a consulta produziu resultado verificando se a função mysqli_stmt_result_metadata() retorna
false
.
statement
Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().
Se o relatório de erros da extensão mysqli estiver habilitado (MYSQLI_REPORT_ERROR
) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como MYSQLI_REPORT_STRICT
,
uma exceção mysqli_sql_exception será lançada em vez do aviso.
Exemplo #1 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 Name LIMIT 20";
$stmt = $mysqli->prepare($query);
$stmt->execute();
/* armazena o resultado em um buffer interno */
$stmt->store_result();
printf("Número de linhas: %d.\n", $stmt->num_rows);
Exemplo #2 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 Name LIMIT 20";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_execute($stmt);
/* armazena o resultado em um buffer interno */
mysqli_stmt_store_result($stmt);
printf("Número de linhas: %d.\n", mysqli_stmt_num_rows($stmt));
Os exemplos acima produzirão:
Número de linhas: 20.