Tabelle B.73
Funktionsübersicht der MySQL C-API
| Funktion
|
Bedeutung
|
| my_ulonglong
mysql_affected_rows(
MYSQL *mysql);
|
Gibt die Anzahl von Zeilen zurück, die durch die letzte UPDATE-, DELETE- oder INSERT-Anfrage geändert, gelöscht bzw. hinzugefügt wurden.
|
| void mysql_close(
MYSQL *mysql);
|
Schließt eine Serververbindung
|
| MYSQL *mysql_connect(
MYSQL *mysql,
const char *host,
const char *user,
const char *passwd);
|
Stellt die Verbindung mit einem MySQL-Server her. Diese Funktion ist veraltet, benutzen Sie dafür mysql_real_connect().
|
| my_bool mysql_change_user(
MYSQL *mysql,
const char *user,
const char *passwd,
const char *db);
|
Ändert Benutzer und Datenbank bei einer geöffneten Verbindung.
|
| const char *
mysql_character_set_name(
MYSQL *mysql);
|
Gibt den Namen des vorgabemäßigen Zeichensatzes für die Verbindung zurück.
|
| int mysql_create_db(
MYSQL *mysql,
const char *db);
|
Erzeugt eine Datenbank. Diese Funktion ist veraltet, benutzen Sie stattdessen den SQL-Befehl CREATE DATABASE.
|
| void mysql_data_seek(
MYSQL_RES *result,
unsigned long long offse);
|
Sucht bis zu einer beliebigen Zeile in einer Anfrage-Ergebnismenge.
|
| void mysql_debug(
char *debug);
|
Macht ein DBUG_PUSH mit der angegebenen Zeichenkette.
|
| int mysql_drop_db(
MYSQL *mysql,
const char *db) ;
|
Löscht eine Datenbank. Diese Funktion ist veraltet, benutzen Sie stattdessen den SQL-Befehl DROP DATABASE.
|
| int mysql_dump_debug_info(
MYSQL *mysql);
|
Veranlasst den Server, Debug-Informationen in die Log-Datei zu schreiben.
|
| my_bool mysql_eof(
MYSQL_RES *result);
|
Stellt fest, ob die letzte Zeile der Ergebnismenge gelesen wurde oder nicht. Diese Funktion ist veraltet, benutzen Sie stattdessen mysql_errno() oder mysql_error().
|
| unsigned int mysql_errno(
MYSQL *mysql);
|
Gibt die Fehlernummer der zuletzt aufgerufenen MySQL-Funktion zurück.
|
| char *mysql_error(
MYSQL *mysql);
|
Gibt die Fehlermeldung der zuletzt aufgerufenen MySQL-Funktion zurück.
|
| unsigned int
mysql_real_escape_string(
MYSQL *mysql,
char *nach,
const char *von,
unsigned int laenge);
|
Escape-Sonderzeichen in einer Zeichenkette, die für ein SQL-Statement benutzt wird, wobei der aktuelle Zeichensatz der Verbindung berücksichtigt wird.
|
| unsigned int
mysql_escape_string(
MYSQL *mysql,
char *nach,
const char *von,
unsigned int laenge);
|
Escape-Sonderzeichen in einer Zeichenkette, die für ein SQL-Statement benutzt wird.
|
| MYSQL_FIELD *
mysql_fetch_field(
MYSQL_RES *result);
|
Gibt den Typ des nächsten Tabellenfelds zurück.
|
| MYSQL_FIELD *
mysql_fetch_field_direct(
MYSQL_RES *result,
unsigned int fieldnr);
|
Gibt den Typ eines Tabellenfelds zurück, angegeben durch eine Feldnummer.
|
| MYSQL_FIELD *
mysql_fetch_fields(
MYSQL_RES *result);
|
Gibt ein Array aller Feldstrukturen zurück.
|
| unsigned lont *
mysql_fetch_lengths(
MYSQL_RES *result);
|
Gibt die Länge aller Spalten in der aktuellen Zeile zurück.
|
| MYSQL_ROW
mysql_fetch_row(
MYSQL_RES *result);
|
Holt die nächste Zeile aus der Ergebnismenge.
|
| MYSQL_FIELD_OFFSET
mysql_field_seek(
MYSQL_RES *result,
MYSQL_FIELD_OFFSET offs);
|
Setzt den Spaltencursor auf eine bestimmte Spalte.
|
| unsigned int
mysql_field_count(
MYSQL *mysql);
|
Gibt die Anzahl der Ergebnisspalten für die letzte Anfrage zurück.
|
| MYSQL_FIELD_OFFSET
mysql_field_tell(
MYSQL_RES *result);
|
Gibt die Position des Feldcursors zurück, der für das letzte mysql_fetch_field() benutzt wurde.
|
| void mysql_free_result(
MYSQL_RES *result);
|
Gibt Speicher frei, der von einer Ergebnismenge benutzt wird.
|
| char *
mysql_get_client_info()
|
Gibt Client-Versionsinformationen zurück.
|
| char *
mysql_get_host_info(
MYSQL *mysql);
|
Gibt eine Zeichenkette zurück, welche die Verbindung beschreibt.
|
| unsigned int
mysql_get_proto_info(
MYSQL *mysql);
|
Gibt die Protokollversion zurück, die von der Verbindung benutzt wird.
|
| char *
mysql_get_server_info(
MYSQL *mysql);
|
Gibt die Server-Versionsnummer zurück.
|
| char *mysql_info(
MYSQL *mysql);
|
Gibt Informationen über die zuletzt ausgeführte Anfrage zurück.
|
| MYSQL *mysql_init(
MYSQL *mysql);
|
Holt oder initialisiert eine MYSQL-Struktur.
|
| my_unlonglong
mysql_insert_id(
MYSQL *mysql);)
|
Gibt die Kennung zurück, die für eine AUTO_INCREMENT-Spalte durch die letzte Anfrage erzeugt wurde.
|
| int mysql_kill(
MYSQL *mysql,
unsigned long pid);
|
Tötet einen angegebenen Thread.
|
| MYSQL_RES *mysql_list_dbs(
MYSQL *mysql,
const char *wild);
|
Gibt die Datenbanknamen zurück, die mit einem einfachen regulären Ausdruck übereinstimmen.
|
| MYSQL_RES *
mysql_list_fields(
MYSQL *mysql,
const char *table,
const char *wild);
|
Gibt die Feldnamen zurück, die mit einem einfachen regulären Ausdruck übereinstimmen.
|
| MYSQL_RES *
mysql_list_processes(
MYSQL *mysql);
|
Gibt eine Liste der aktuellen Server-Threads zurück.
|
| MYSQL_RES *
mysql_list_tables(
MYSQL *mysql,
const char *wild);
|
Gibt Tabellenamen zurück, die mit einem einfachen regulären Ausdruck übereinstimmen.
|
| unsigned int
mysql_num_fields(
MYSQL_RES *result);
|
Gibt die Anzahl von Spalten in einer Ergebnismenge zurück.
|
| my_ulonglong
mysql_num_rows(
MYSQL_RES *result);
|
Gibt die Anzahl von Zeilen in einer Ergebnismenge zurück.
|
| int mysql_options(
MYSQL *mysql,
enum mysql_option option,
const char *arg);
|
Setzt Verbindungsoptionen für mysql_connect().
|
| int mysql_ping(
MYSQL *mysql);
|
Prüft, ob die Verbindung zum Server funktioniert oder nicht, und verbindet sich erneut, falls notwendig.
|
| int mysql_query(
MYSQL *mysql,
const char *query);
|
Führt eine SQL-Anfrage aus, die als NULL-begrenzte Zeichenkette angegeben wird.
|
| MYSQL *
mysql_real_connect(
MYSQL *mysql,
const char *host,
const char *user,
const char *passwd,
const char *db,
unsigned int port,
const char *unix_socket,
unsigned int client_flag
);
|
Verbindet sich mit einem MySQL-Server.
|
| mysql_real_query(
MYSQL *mysql,
const char *query,
unsigned int len);
|
Führt eine SQL-Anfrage aus, die als gezählte Zeichenkette angegeben wird.
|
| int mysql_reload(
MYSQL *mysql);
|
Weist den Server an, die Berechtigungstabellen erneut zu laden.
|
| MYSQL_ROW_OFFSET
mysql_row_seek(
MYSQL_RES *result,
MYSQL_ROW_OFFSET off);
|
Sucht bis zu einer Zeile in einer Ergebnismenge, indem sie den Wert benutzt, der von mysql_row_tell() zurückgegeben wird.
|
| MYSQL_ROW_OFFSET
mysql_row_tell(
MYSQL_RES *result);
|
Gibt die Zeilencursorposition zurück.
|
| int mysql_select_db(
MYSQL *mysql,
const char *db);
|
Wählt eine Datenbank aus.
|
| int mysql_shutdown(
MYSQL *mysql);
|
Fährt den Datenbankserver herunter.
|
| char *mysql_stat(
MYSQL *mysql);
|
Gibt den Serverstatus als Zeichenkette zurück.
|
| MYSQL_RES *
mysql_store_result(
MYSQL *mysql);
|
Ruft eine vollständige Ergebnismenge zum Client ab.
|
| unsigned long
mysql_thread_id(
MYSQL *mysql);
|
Gibt die aktuelle Thread-Kennung zurück.
|
| mysql_thread_safe()
|
Gibt 1 zurück, wenn die Clients Thread-sicher kompiliert sind.
|
| MYSQL_RES *
mysql_use_result(
MYSQL *mysql);
|
Initialisiert den zeilenweisen Abruf einer Ergebnismenge.
|
Auch zu den eigenen Datentypen von MySQL und der C-API erfolgt hier ein kurzer Überblick.
