mysqli_stmt::store_result

mysqli_stmt_store_result

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::store_result -- mysqli_stmt_store_result — Armazena um conjunto de resultados em um buffer interno

Descrição

Estilo orientado a objetos

public mysqli_stmt::store_result(): bool

Estilo procedural

mysqli_stmt_store_result(mysqli_stmt $statement): bool

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.

Note:

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

Parâmetros

statement

Somente no estilo procedural: Um objeto mysqli_stmt retornado por mysqli_stmt_init().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

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.

Exemplos

Example #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);

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

Veja Também