MYSQL_FIELD *mysql_fetch_field(MYSQL_RES *result)

Beschreibung

Liefert die Definition einer Spalte einer Ergebnismenge in Form einer MYSQL_FIELD-Struktur. Um Informationen über alle Spalten der Ergebnismenge zu erhalten, rufen Sie diese Funktion wiederholt auf. mysql_fetch_field() liefert NULL, wenn keine weiteren Felder mehr übrig sind.

Mit jeder neuen SELECT-Anfrage wird mysql_fetch_field() so zurückgesetzt, dass sie wieder Informationen über das erste Feld liefert. Auch mysql_field_seek() nimmt Einfluss darauf, welches Feld mysql_fetch_field() zurückgibt.

Wenn Sie mit mysql_query() ein SELECT auf einer Tabelle ausgeführt haben, ohne jedoch mysql_store_result() zu benutzen, dann liefert MySQL, wenn Sie mit mysql_fetch_field() die Länge eines BLOB-Felds erfragen, die Standardlänge eines Blob-Werts (8 Kbyte). (Die Größe von 8 Kbyte wird gewählt, weil MySQL die maximale Länge für den BLOB nicht kennt. Irgendwann soll dies einmal konfigurierbar gemacht werden.) Wenn Sie die Ergebnismenge abgeholt haben, enthält field->max_length die Länge des längsten Werts dieser Spalte für diese konkrete Anfrage.

Rückgabewerte

Die MYSQL_FIELD-Struktur der aktuellen Spalte. NULL, wenn keine Spalten mehr übrig sind.

Fehler

Keine.

Beispiel

MYSQL_FIELD *field;

while((field = mysql_fetch_field(result)))
{
    printf("field name %s\n", field->name);
}