int mysql_query(MYSQL *mysql, const char *stmt_str)
説明
NULL 終端文字列 stmt_str
によって指示される SQL ステートメントを実行します。通常、文字列は終端のセミコロン (「;
」) または \g
を含まない単一の SQL ステートメントから構成されている必要があります。複数ステートメントの実行が有効にされている場合、文字列には、セミコロンで区切られた複数のステートメントを含めることができます。セクション23.7.17「複数ステートメント実行の C API サポート」を参照してください。
バイナリデータを含むステートメントには、mysql_query()
を使うことはできません。代わりに、mysql_real_query()
を使う必要があります。(バイナリデータには、mysql_query()
がステートメント文字列の終端と解釈する 「\0
」 文字が含まれることがあります。)
ステートメントが結果セットを返すかどうかを知りたい場合は、mysql_field_count()
を使用してこれをチェックできます。セクション23.7.7.22「mysql_field_count()」を参照してください。
戻り値
成功の場合はゼロ。エラーが発生した場合、ゼロ以外。
エラー
-
CR_COMMANDS_OUT_OF_SYNC
コマンドが正しくない順番で実行されました。
-
CR_SERVER_GONE_ERROR
MySQL サーバーが存在しなくなりました。
-
CR_SERVER_LOST
サーバーへの接続がクエリー中に失われました。
-
CR_UNKNOWN_ERROR
不明なエラーが発生しました。