mysqli_stmt::$num_rows

mysqli_stmt::num_rows

mysqli_stmt_num_rows

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::$num_rows -- mysqli_stmt::num_rows -- mysqli_stmt_num_rows — Liefert die Anzahl der vom Server abgerufenen Datensätze

Beschreibung

Objektorientierter Stil

int|string $mysqli_stmt->num_rows;
public mysqli_stmt::num_rows(): int|string

Prozeduraler Stil

mysqli_stmt_num_rows(mysqli_stmt $statement): int|string

Gibt die Anzahl der Datensätze zurück, die im Anweisungshandle gepuffert sind. Diese Funktion funktioniert erst, wenn die gesamte Ergebnismenge mit mysqli_stmt_store_result() in einem Anweisungshandle gepuffert wurde.

Diese Funktion gibt 0 zurück, solange nicht alle Datensätze vom Server abgerufen wurden.

Parameter-Liste

statement

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

Rückgabewerte

Gibt die Anzahl der gepufferten Zeilen als Integer zurück. Gibt im ungepufferten Modus 0 zurück, solange nicht alle Datensätze vom Server abgerufen wurden.

Hinweis:

Wenn die Anzahl der Zeilen größer ist als PHP_INT_MAX, wird die Anzahl als String zurückgegeben.

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, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = $mysqli->prepare($query);
$stmt->execute();

/* Das Ergebnis im internen Puffer speichern */
$stmt->store_result();

printf("Die Anzahl der Datensätze: %d.\n", $stmt->num_rows);

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, CountryCode FROM City ORDER BY Name LIMIT 20";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_execute($stmt);

/* Das Ergebnis im internen Puffer speichern */
mysqli_stmt_store_result($stmt);

printf("Die Anzahl der Datensätze: %d.\n", mysqli_stmt_num_rows($stmt));

Die obigen Bespiele erzeugen folgende Ausgabe:

Die Anzahl der Datensätze: 20.

Siehe auch