int mysql_real_query(MYSQL *mysql, const char *query,
unsigned long length)
Beschreibung
Führt die SQL-Anfrage aus, auf die query
verweist. Diese sollte ein length
Bytes
langer String sein. Normalerweise muss der String eine
einzelne SQL-Anweisung ohne abschließendes Semikolon
(‘;
’) oder
\g
enthalten. Wenn Mehrfachanweisungen
aktiviert sind, kann der String auch mehrere durch Semikola
getrennte Anweisungen enthalten. Siehe
Abschnitt 24.2.9, „C-API: Behandlung der Ausführung mehrerer Anweisungen“.
Sie müssen
mysql_real_query()
anstelle von
mysql_query()
benutzen, wenn Ihre Anfragen
Binärdaten enthalten, da diese das
‘\0
’-Zeichen enthalten können.
Überdies ist die Funktion
mysql_real_query()
schneller als
mysql_query()
, da sie nicht
strlen()
auf dem Anfrage-String aufruft.
Wenn Sie wissen möchten, ob die Anfrage eigentlich eine
Ergebnismenge zurückliefern sollte, können Sie dies mit
mysql_field_count()
überprüfen. Siehe
Abschnitt 24.2.3.22, „mysql_field_count()
“.
Rückgabewerte
Null, wenn die Anfrage Erfolg hatte. Ein von null verschiedener Wert, wenn ein Fehler auftrat.
Fehler
CR_COMMANDS_OUT_OF_SYNC
Befehle wurden in der falschen Reihenfolge ausgeführt.
CR_SERVER_GONE_ERROR
Der MySQL Server ist nicht mehr verfügbar.
CR_SERVER_LOST
Die Serververbindung brach während der Anfrage ab.
CR_UNKNOWN_ERROR
Ein unbekannter Fehler ist aufgetreten.
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.