mysqli_stmt::get_result

mysqli_stmt_get_result

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

mysqli_stmt::get_result -- mysqli_stmt_get_result — Ruft die Ergebnismenge aus einer vorbereiteten Anweisung als mysqli_result-Objekt ab

Beschreibung

Objektorientierter Stil

public mysqli_stmt::get_result(): mysqli_result|false

Prozeduraler Stil

mysqli_stmt_get_result(mysqli_stmt $statement): mysqli_result|false

Ruft eine Ergebnismenge aus einer vorbereiteten Anweisung als mysqli_result-Objekt ab. Die Daten werden vom MySQL-Server an PHP übertragen. Diese Methode sollte nur bei Abfragen aufgerufen werden, die eine Ergebnismenge erzeugen.

Hinweis:

Nur in mysqlnd verfügbar.

Hinweis:

Diese Funktion kann nicht zusammen mit mysqli_stmt_store_result() verwendet werden. Beide Funktionen rufen die komplette Ergebnismenge vom MySQL-Server ab.

Parameter-Liste

statement

Nur bei prozeduralem Aufruf: ein von mysqli_stmt_init() zurückgegebenes mysqli_stmt-Objekt.

Rückgabewerte

Gibt bei einem Fehler false zurück. Bei erfolgreichen Abfragen, die eine Ergebnismenge erzeugen, also z. B. SELECT, SHOW, DESCRIBE oder EXPLAIN, gibt mysqli_stmt_get_result() ein mysqli_result-Objekt zurück. Bei anderen erfolgreichen Abfragen gibt mysqli_stmt_get_result() false zurück. Mit der Funktion mysqli_stmt_errno() kann zwischen den beiden Gründen für false unterschieden werden; aufgrund eines Fehlers musste dafür vor PHP 7.4.13 die Funktion mysqli_errno() verwendet werden.

Fehler/Exceptions

If mysqli error reporting is enabled (MYSQLI_REPORT_ERROR) and the requested operation fails, a warning is generated. If, in addition, the mode is set to MYSQLI_REPORT_STRICT, a mysqli_sql_exception is thrown instead.

Beispiele

Beispiel #1 Objektorientierter Stil

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

$query = "SELECT Name, Population, Continent FROM Country WHERE Continent=? ORDER BY Name LIMIT 1";

$stmt = $mysqli->prepare($query);
$stmt->bind_param("s", $continent);

$continentList = array('Europe', 'Africa', 'Asia', 'North America');

foreach ($continentList as $continent) {
$stmt->execute();
$result = $stmt->get_result();
while ($row = $result->fetch_array(MYSQLI_NUM)) {
foreach ($row as $r) {
print "$r ";
}
print "\n";
}
}

Beispiel #2 Prozeduraler Stil

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

$query = "SELECT Name, Population, Continent FROM Country WHERE Continent=? ORDER BY Name LIMIT 1";

$stmt = mysqli_prepare($link, $query);
mysqli_stmt_bind_param($stmt, "s", $continent);

$continentList= array('Europe', 'Africa', 'Asia', 'North America');

foreach ($continentList as $continent) {
mysqli_stmt_execute($stmt);
$result = mysqli_stmt_get_result($stmt);
while ($row = mysqli_fetch_array($result, MYSQLI_NUM)) {
foreach ($row as $r) {
print "$r ";
}
print "\n";
}
}

Oben gezeigte Beispiele erzeugen eine ähnliche Ausgabe wie:

Albania 3401200 Europe
Algeria 31471000 Africa
Afghanistan 22720000 Asia
Anguilla 8000 North America

Siehe auch