mysqli_result::fetch_column

mysqli_fetch_column

(PHP 8 >= 8.1.0)

mysqli_result::fetch_column -- mysqli_fetch_column — Ruft eine einzelne Spalte aus der nächsten Zeile einer Ergebnismenge ab

Beschreibung

Objektorientierter Stil

public mysqli_result::fetch_column(int $column = 0): null|int|float|string|false

Prozeduraler Stil

mysqli_fetch_column(mysqli_result $result, int $column = 0): null|int|float|string|false

Ruft eine Zeile aus der Ergebnismenge ab und gibt den Wert der durch den nullbasierten Index angegebenen Spalte zurück. Jeder nachfolgende Aufruf dieser Funktion gibt den Wert aus der nächsten Zeile der Ergebnismenge zurück oder false, wenn es keine weitere Zeile gibt.

Hinweis: Diese Funktion setzt NULL-Felder auf den PHP-Wert null.

Parameter-Liste

result: Nur bei prozeduralem Aufruf: Ein von mysqli_query(), mysqli_store_result(), mysqli_use_result() oder mysqli_stmt_get_result() zurückgegebenes mysqli_result-Objekt.
column: Die Nummer der nullbasierten Spalte, die aus der Zeile abgerufen werden soll. Wenn kein Wert angegeben wird, wird der Wert der ersten Spalte zurückgegeben.

Rückgabewerte

Gibt den Wert einer einzelnen Spalte aus der nächsten Zeile einer Ergebnismenge zurück oder false, wenn es keine weitere Zeile gibt.

Warnung

Mit dieser Funktion ist es nicht möglich, eine weitere Spalte aus derselben Zeile zurückzugeben.

Beispiele

Beispiel #1 mysqli_result::fetch_column()-Beispiel

Objektorientierter Stil

<?php

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

$query = "SELECT CountryCode, Name FROM City ORDER BY ID DESC LIMIT 5";

$result = $mysqli->query($query);

/* einen einzelnen Wert aus der zweiten Spalte abrufen */
while ($Name = $result->fetch_column(1)) {
    printf("%s\n", $Name);
}

Prozeduraler Stil

<?php

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

$query = "SELECT CountryCode, Name FROM City ORDER BY ID DESC LIMIT 5";

$result = mysqli_query($mysqli, $query);

/* einen einzelnen Wert aus der zweiten Spalte abrufen */
while ($Name = mysqli_fetch_column($result, 1)) {
    printf("%s\n", $Name);
}

Oben gezeigte Beispiele erzeugen eine ähnliche Ausgabe wie:

Rafah
Nablus
Jabaliya
Hebron
Khan Yunis

Siehe auch

mysqli_fetch_all() - Ruft alle Ergebniszeilen als assoziatives und/oder numerisches Array ab
mysqli_fetch_array() - Ruft die nächste Zeile einer Ergebnismenge als assoziatives und/oder numerisches Array ab
mysqli_fetch_assoc() - Ruft die nächste Zeile einer Ergebnismenge als assoziatives Array ab
mysqli_fetch_object() - Liefert die nächste Zeile einer Ergebnismenge als Objekt
mysqli_fetch_row() - Liefert die nächste Zeile einer Ergebnismenge als numerisches Array
mysqli_data_seek() - Verschiebt den Ergebniszeiger auf die angegebene Zeile