- 24.2.3 C-API: Funktionsbeschreibungen
- 24.2.3.1 mysql_affected_rows()
- 24.2.3.2 mysql_autocommit()
- 24.2.3.3 mysql_change_user()
- 24.2.3.4 mysql_character_set_name()
- 24.2.3.5 mysql_close()
- 24.2.3.6 mysql_commit()
- 24.2.3.7 mysql_connect()
- 24.2.3.8 mysql_create_db()
- 24.2.3.9 mysql_data_seek()
- 24.2.3.10 mysql_debug()
- 24.2.3.11 mysql_drop_db()
- 24.2.3.12 mysql_dump_debug_info()
- 24.2.3.13 mysql_eof()
- 24.2.3.14 mysql_errno()
- 24.2.3.15 mysql_error()
- 24.2.3.16 mysql_escape_string()
- 24.2.3.17 mysql_fetch_field()
- 24.2.3.18 mysql_fetch_field_direct()
- 24.2.3.19 mysql_fetch_fields()
- 24.2.3.20 mysql_fetch_lengths()
- 24.2.3.21 mysql_fetch_row()
- 24.2.3.22 mysql_field_count()
- 24.2.3.23 mysql_field_seek()
- 24.2.3.24 mysql_field_tell()
- 24.2.3.25 mysql_free_result()
- 24.2.3.26 mysql_get_character_set_info()
- 24.2.3.27 mysql_get_client_info()
- 24.2.3.28 mysql_get_client_version()
- 24.2.3.29 mysql_get_host_info()
- 24.2.3.30 mysql_get_proto_info()
- 24.2.3.31 mysql_get_server_info()
- 24.2.3.32 mysql_get_server_version()
- 24.2.3.33 mysql_hex_string()
- 24.2.3.34 mysql_info()
- 24.2.3.35 mysql_init()
- 24.2.3.36 mysql_insert_id()
- 24.2.3.37 mysql_kill()
- 24.2.3.38 mysql_library_end()
- 24.2.3.39 mysql_library_init()
- 24.2.3.40 mysql_list_dbs()
- 24.2.3.41 mysql_list_fields()
- 24.2.3.42 mysql_list_processes()
- 24.2.3.43 mysql_list_tables()
- 24.2.3.44 mysql_more_results()
- 24.2.3.45 mysql_next_result()
- 24.2.3.46 mysql_num_fields()
- 24.2.3.47 mysql_num_rows()
- 24.2.3.48 mysql_options()
- 24.2.3.49 mysql_ping()
- 24.2.3.50 mysql_query()
- 24.2.3.51 mysql_real_connect()
- 24.2.3.52 mysql_real_escape_string()
- 24.2.3.53 mysql_real_query()
- 24.2.3.54 mysql_refresh()
- 24.2.3.55 mysql_reload()
- 24.2.3.56 mysql_rollback()
- 24.2.3.57 mysql_row_seek()
- 24.2.3.58 mysql_row_tell()
- 24.2.3.59 mysql_select_db()
- 24.2.3.60 mysql_set_character_set()
- 24.2.3.61 mysql_set_server_option()
- 24.2.3.62 mysql_shutdown()
- 24.2.3.63 mysql_sqlstate()
- 24.2.3.64 mysql_ssl_set()
- 24.2.3.65 mysql_stat()
- 24.2.3.66 mysql_store_result()
- 24.2.3.67 mysql_thread_id()
- 24.2.3.68 mysql_use_result()
- 24.2.3.69 mysql_warning_count()
MYSQL_ROW mysql_fetch_row(MYSQL_RES
*result)
Beschreibung
Ruft die nächste Zeile einer Ergebnismenge ab. Nach
mysql_store_result() aufgerufen, liefert
mysql_fetch_row() den Wert
NULL, wenn keine weiteren Zeilen mehr
abzuholen sind. Nach mysql_use_result()
aufgerufen, liefert mysql_fetch_row() den
Wert NULL, wenn keine Zeilen mehr vorliegen
oder wenn ein Fehler auftrat.
mysql_num_fields(result) gibt die Anzahl
der Werte in einer Zeile an. Wenn row den
Rückgabewert eines
mysql_fetch_row()-Aufrufs speichert,
können Sie mit row[0] bis
row[mysql_num_fields(result)-1] die Zeiger
auf die Werte dieser Zeile ansprechen.
NULL-Werte in der Zeile werden durch
NULL-Zeiger angezeigt.
Die Längen der Feldwerte der Zeile können Sie sich mit
mysql_fetch_lengths() beschaffen. Leere
Felder und Felder mit NULL haben beide die
Länge null. Sie können sie unterscheiden, indem Sie sich den
Zeiger auf den Feldwert anschauen: Ist er
NULL, speichert das Feld den Wert
NULL; andernfalls ist es leer.
Rückgabewerte
Eine MYSQL_ROW-Struktur für die nächste
Zeile oder NULL, wenn keine weiteren Zeilen
mehr vorliegen oder ein Fehler aufgetreten ist.
Fehler
Beachten Sie, dass der Fehler zwischen zwei Aufrufen von
mysql_fetch_row() nicht zurückgesetzt
wird.
-
CR_SERVER_LOSTDie Serververbindung brach während der Anfrage ab.
-
CR_UNKNOWN_ERROREin unbekannter Fehler ist aufgetreten.
Beispiel
MYSQL_ROW row;
unsigned int num_fields;
unsigned int i;
num_fields = mysql_num_fields(result);
while ((row = mysql_fetch_row(result)))
{
unsigned long *lengths;
lengths = mysql_fetch_lengths(result);
for(i = 0; i < num_fields; i++)
{
printf("[%.*s] ", (int) lengths[i], row[i] ? row[i] : "NULL");
}
printf("\n");
}
Dies ist eine Übersetzung des MySQL-Referenzhandbuchs, das sich auf dev.mysql.com befindet. Das ursprüngliche Referenzhandbuch ist auf Englisch, und diese Übersetzung ist nicht notwendigerweise so aktuell wie die englische Ausgabe. Das vorliegende deutschsprachige Handbuch behandelt MySQL bis zur Version 5.1.
