int mysql_next_result(MYSQL *mysql)
説明
取得されていない結果セットが存在する場合、mysql_next_result()
は次のクエリの結果セットを読み込み、ステータスをアプリケーションに返します。この関数は、MySQL
4.1 で追加されました。
注意:
前のクエリが結果セットを返していた場合、mysql_free_result()
を呼び出す必要があります。
mysql_next_result()
を呼び出した後、接続の状態は次のクエリについて
mysql_real_query()
を呼び出した後と同様になります。これは、この関数を呼び出した後、この接続で
mysql_store_result()
、mysql_warning_count()
、mysql_affected_rows()
などを呼び出すことができることを意味します。
mysql_next_result()
がエラーを返した場合、他のステートメントは実行されません。また、取得されていない結果セットも存在しません。
See 項11.1.8. 「C API における複数クエリの実行の取り扱い」。
戻り値
呼び出しが正常に動作し、取得する結果セットが存在していた場合は 0、取得する結果セットが存在しなかった場合は -1、エラーが発生した場合は正の値。
エラー
CR_COMMANDS_OUT_OF_SYNC
コマンドが正しい順序で実行されなかった。たとえば、前の結果セットで
mysql_use_result()
が呼び出されなかった場合にこのエラーが発生する。
CR_SERVER_GONE_ERROR
MySQL サーバがいなくなった。
CR_SERVER_LOST
クエリの実行中にサーバへの接続が切断された。
CR_UNKNOWN_ERROR
不明なエラーが発生した。
This is a translation of the MySQL Reference Manual that can be found at dev.mysql.com. The original Reference Manual is in English, and this translation is not necessarily as up to date as the English version.