Liefert die Anzahl der vom Server abgerufenen Datensätze

# 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 function mysqli_stmt::num_rows(): int|string

Prozeduraler Stil

function 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

- mysqli_stmt_store_result() - Speichert eine Ergebnismenge in einem internen Puffer
- mysqli_stmt_affected_rows() - Liefert die gesamte Anzahl der Datensätze, die bei der letzten ausgeführten Anweisung geändert, gelöscht, eingefügt oder abgeglichen wurden
- mysqli_prepare() - Bereitet eine SQL-Anweisung zur Ausführung vor

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open