
Kapitel 9: MySQL-APIs 581
Beschreibung
F¨uhrt die SQL-Anfrage aus, auf die durch die NULL-begrenzte Zeichenkette anfrage gezeigt
wird. Die Anfrage muss aus einem einzelnen SQL-Statement bestehen. Sie d¨urfen kein
Semikolon (‘;’) oder \g zum Statement hinzuf¨ugen.
mysql_query() kann nicht f¨ur Anfragen benutzt werden, die Bin¨ardaten enthalten. Hi-
erf¨ur sollten Sie statt dessen mysql_real_query() benutzen. (Bin¨ardaten k¨onnen das ‘\0’-
Zeichen enthalten, was mysql_query() als Ende der Anfrage-Zeichenkette interpretiert.)
Wenn Sie wissen wollen, ob die Anfrage eine Ergebnismenge zur¨uckgeben sollte oder nicht,
k¨onnen Sie mysql_field_count() benutzen, um hierauf zu pr¨ufen. Siehe Abschnitt 9.4.3.20
[mysql_field_count], Seite 567.
R¨uckgabewerte
0, wenn die Anfrage erfolgreich war. Nicht-0, wenn ein Fehler auftrat.
Fehler
CR_COMMANDS_OUT_OF_SYNC
Befehle wurden nicht in der korrekten Reihenfolge ausgef¨uhrt.
CR_SERVER_GONE_ERROR
Der MySQL-Server ist weg.
CR_SERVER_LOST
Die Verbindung zum Server ging w¨ahrend der Anfrage verloren.
CR_UNKNOWN_ERROR
Ein unbekannter Fehler trat auf.
9.4.3.41 mysql_real_connect()
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)
Beschreibung
mysql_real_connect() versucht, eine Verbindung zu einer MySQL-Datenbankmaschine
aufzubauen, die auf host l¨auft. mysql_real_connect() muss erfolgreich verlaufen sein,
bevor Sie irgend eine andere API-Funktion ausf¨uhren k¨onnen, mit Ausnahme von mysql_
get_client_info().
Die Parameter werden wie folgt angegeben:
• Der erste Parameter sollte die Adresse einer existierenden MYSQL-Struktur sein. Vor
dem Aufruf von mysql_real_connect() m¨ussen Sie mysql_init() aufrufen, um die
MYSQL-Struktur zu initialisieren. Sie k¨onnen viele der Verbindungsoptionen mit dem
mysql_options()-Aufruf ¨andern. Siehe Abschnitt 9.4.3.38 [mysql options], Seite 578.
Comentarios a estos manuales