- 23.2.3 C API機能の説明
- 23.2.3.1 mysql_affected_rows()
- 23.2.3.2 mysql_autocommit()
- 23.2.3.3 mysql_change_user()
- 23.2.3.4 mysql_character_set_name()
- 23.2.3.5 mysql_close()
- 23.2.3.6 mysql_commit()
- 23.2.3.7 mysql_connect()
- 23.2.3.8 mysql_create_db()
- 23.2.3.9 mysql_data_seek()
- 23.2.3.10 mysql_debug()
- 23.2.3.11 mysql_drop_db()
- 23.2.3.12 mysql_dump_debug_info()
- 23.2.3.13 mysql_eof()
- 23.2.3.14 mysql_errno()
- 23.2.3.15 mysql_error()
- 23.2.3.16 mysql_escape_string()
- 23.2.3.17 mysql_fetch_field()
- 23.2.3.18 mysql_fetch_field_direct()
- 23.2.3.19 mysql_fetch_fields()
- 23.2.3.20 mysql_fetch_lengths()
- 23.2.3.21 mysql_fetch_row()
- 23.2.3.22 mysql_field_count()
- 23.2.3.23 mysql_field_seek()
- 23.2.3.24 mysql_field_tell()
- 23.2.3.25 mysql_free_result()
- 23.2.3.26 mysql_get_character_set_info()
- 23.2.3.27 mysql_get_client_info()
- 23.2.3.28 mysql_get_client_version()
- 23.2.3.29 mysql_get_host_info()
- 23.2.3.30 mysql_get_proto_info()
- 23.2.3.31 mysql_get_server_info()
- 23.2.3.32 mysql_get_server_version()
- 23.2.3.33 mysql_get_ssl_cipher()
- 23.2.3.34 mysql_hex_string()
- 23.2.3.35 mysql_info()
- 23.2.3.36 mysql_init()
- 23.2.3.37 mysql_insert_id()
- 23.2.3.38 mysql_kill()
- 23.2.3.39 mysql_library_end()
- 23.2.3.40 mysql_library_init()
- 23.2.3.41 mysql_list_dbs()
- 23.2.3.42 mysql_list_fields()
- 23.2.3.43 mysql_list_processes()
- 23.2.3.44 mysql_list_tables()
- 23.2.3.45 mysql_more_results()
- 23.2.3.46 mysql_next_result()
- 23.2.3.47 mysql_num_fields()
- 23.2.3.48 mysql_num_rows()
- 23.2.3.49 mysql_options()
- 23.2.3.50 mysql_ping()
- 23.2.3.51 mysql_query()
- 23.2.3.52 mysql_real_connect()
- 23.2.3.53 mysql_real_escape_string()
- 23.2.3.54 mysql_real_query()
- 23.2.3.55 mysql_refresh()
- 23.2.3.56 mysql_reload()
- 23.2.3.57 mysql_rollback()
- 23.2.3.58 mysql_row_seek()
- 23.2.3.59 mysql_row_tell()
- 23.2.3.60 mysql_select_db()
- 23.2.3.61 mysql_set_character_set()
- 23.2.3.62 mysql_set_local_infile_default()
- 23.2.3.63 mysql_set_local_infile_handler()
- 23.2.3.64 mysql_set_server_option()
- 23.2.3.65 mysql_shutdown()
- 23.2.3.66 mysql_sqlstate()
- 23.2.3.67 mysql_ssl_set()
- 23.2.3.68 mysql_stat()
- 23.2.3.69 mysql_store_result()
- 23.2.3.70 mysql_thread_id()
- 23.2.3.71 mysql_use_result()
- 23.2.3.72 mysql_warning_count()
int mysql_next_result(MYSQL *mysql)
説明
この機能は、シングルステートメントストリングとして規定された複数のステートメントを実行するとき、もしくは複数の結果セットを戻すCALLステートメントを実行するとき使用します。
もっと多くの結果が存在している場合、mysql_next_result()は次のステートメントを読み取り、そのステータスをアプリケーションに返送します。
それが結果セットを戻したクエリーである場合、mysql_next_result()を呼び出す前に、先行ステートメントのために、mysql_free_result()を呼び出さなければなりません｡
mysql_next_result()を呼び出した後の接続は、次のステートメントのために、mysql_real_query()またはmysql_query()を呼び出したかのような状態になります。これは、mysql_store_result()、mysql_warning_count()、mysql_affected_rows()等を呼び出すことができることを意味します。
mysql_next_result()がエラーを戻す場合、他のステートメントは実行されず、フェッチすべき更なる結果も存在しません。
ユーザのプログラムが CALL SQL
ステートメントで保存されたプロシージャを実行する場合、必ず
CLIENT_MULTI_RESULTSフラグを明確に設定するか、mysql_real_connect()に通信するとき
CLIENT_MULTI_STATEMENTS
にセットすることで必然的にフラグが設定されるようにしてください。これは、各CALLは、手順の中で実行されたステートメントによって戻すべき結果に加え、呼び出しのステータスを示す結果を戻すことに起因して起こります。更に、CALLは複数の結果を戻すことができるので、これらの結果を、mysql_next_result()を呼び出して、更なる結果がないか査定するループを使って処理すべきです。
mysql_next_result()を使用する方法を示す例については、項23.2.9. 「マルチプルステートメントを実行するＣ
APIハンドリング」をご参照ください。
戻り値
| 戻り値 | 摘要 |
| 0 | 成功し且つ結果が更に存在する。 |
| -1 | 成功し且つ結果が更に存在しない。 |
| >0 | エラーが発生した。 |
エラー
-
CR_COMMANDS_OUT_OF_SYNCコマンドが妥当でないオーダーで実行されました。例えば、前の結果セットに対して、
mysql_use_result()を呼び出さなかった場合。 -
CR_SERVER_GONE_ERRORMySQLサーバが立ち去りました。
-
CR_SERVER_LOSTサーバへの接続がクエリー中に失われました。
-
CR_UNKNOWN_ERROR未知のエラーが起こりました。
