23.8.11.4 mysql_stmt_bind_param()

my_bool mysql_stmt_bind_param(MYSQL_STMT *stmt, MYSQL_BIND *bind)

説明

mysql_stmt_bind_param() は、mysql_stmt_prepare() に渡された SQL ステートメント内のパラメータマーカーに入力データをバインドするために使用します。それは MYSQL_BIND 構造を使用して、データを提供します。bind は MYSQL_BIND 構造の配列のアドレスです。クライアントライブラリは、配列に、クエリーに存在する ? パラメータマーカーごとに 1 つの要素が含まれることを期待します。

次のステートメントを準備するとします。

INSERT INTO mytbl VALUES(?,?,?)

パラメータをバインドする場合、MYSQL_BIND 構造の配列は、3 つの要素が含まれている必要があり、このように宣言できます。

MYSQL_BIND bind[3];

セクション23.8.9「C API プリペアドステートメントデータ構造」に、各 MYSQL_BIND 要素のメンバーおよび入力値を提供するためにそれらを設定する方法について説明しています。

戻り値

成功の場合はゼロ。エラーが発生した場合、ゼロ以外。

エラー

• CR_UNSUPPORTED_PARAM_TYPE

  変換はサポートされていません。buffer_type 値は無効か、サポートされるいずれの型でもない可能性があります。

• CR_OUT_OF_MEMORY

  メモリー不足。

• CR_UNKNOWN_ERROR

  不明なエラーが発生しました。

例

セクション23.8.11.10「mysql_stmt_execute()」の例を参照してください。