インプットに対して、MYSQL_BINDは、mysql_stmt_bind_param()と一緒に、パラメータデータを、mysql_stmt_execute()が使う目的でバッファーに固定するために使われます｡

インプットに対して、MYSQL_BINDはmysql_stmt_bind_result()と一緒に、列をフェッチッするのに使用するため、結果セットバッファーをmysql_stmt_fetch()に固定するのに使われます｡

enum enum_field_types buffer_type

バッファーのタイプ。このメンバーはあなたがステートメントパラメータに固定しているＣ言語変数のデータタイプを示します。許容されるbuffer_type値はこのセクションで後に列記されています。インプットに対して、buffer_typeはサーバに送る値を含む変数のタイプを示します。アウトプットに対してそれは、サーバから受け取った値を記憶させたい変数のタイプを示します。

void *buffer

データの転送に使用する、バッファーに対するポインター。これは変数のアドレスです。

インプットの場合、bufferはステートメントのパラメータが記憶される変数に対するポインターです。mysql_stmt_execute()を呼び出すとき、MySQLは変数に記憶した値を取り込んでそれを、ステートメント中の対応するパラメータ・マーカーの場所に置きます｡

アウトプットの場合、bufferはその中に結果セットのコラム値を戻す変数に対するポインターです。mysql_stmt_fetch()を呼び出すとき、MySQLはカラム値を戻し、それをこの変数の中に記憶します。呼び出しに戻って値にアクセスすることができます。

MySQLが実施する必要のあるクライアント側のＣ言語の値とサーバ側のSQLの値の間のタイプ変換を最小にするため、対応するSQLの値と同等なタイプを含む変数を使ってください。データが数値タイプである場合、bufferをCタイプの適当な数値に指定すべきです。(charまたは整数変数の場合、あなたは、後で述べるunsignedメンバーをこのリストの中にセットすることによって、変数にis_unsigned属性が含まれているか否かも示すべきです。文字(非バイナリー)タイプおよびバイナリース・トリングデータタイプに対して、bufferをバッファーに指定すべきです。日付データタイプおよび時間データタイプに対して、bufferをMYSQL_TIME構造に指すべきです。

後のセクションにあるタイプ変換に関する注をご参照ください。

unsigned long buffer_length

*bufferの実サイズ(バイト)。これはバッファーに記憶することができるデータの最大量を示します｡文字とバイナリーCデータに対して、buffer_length値は、mysql_stmt_bind_param()と一緒に使ってインプット値を規定する*bufferの長さ、またはmysql_stmt_bind_result()と一緒に使うとき、バッファーにフェッチできるアウトプットデータバイトの最大数を規定します。

unsigned long *length

*buffer中に記憶されたデータの実のバイト数を示す*buffer変数に対するポインター。lengthは文字またはバイナリーCデータに使われます。

インプットパラメータデータを結合する場合、lengthは、*buffer中に記憶されたパラメータ値の実際の長さを示すunsigned long変数を指します。これはmysql_stmt_execute()によって使われます。

アアウトプット値を結合する場合、mysql_stmt_fetch()の戻り値は長さの解釈を決めます：

データ値の長さはbuffer_type値によって決まるので、lengthは数値タイプのデータと一時タイプのデータに対して無視されます。

my_bool *is_null

このナンバーは、値がNULLである場合、真で、それがNULLでない場合、虚となるmy_bool変数を指します。インプットに対して、*is_nullを真にセットして、NULL値をステートメントパラメータとして渡すことを示してください。

is_nullはブーリアンスカラーではないが、pointerの代わりにブーリアンスカラーをさす理由は、NULL値を規定する方法にフレキシビリティを提供することです：

アウトプットに対して、is_nullをさす値は、ステートメントから戻された結果セットカラム値がNULLである場合、列をフェッチした後に真にセットされます。

my_bool is_unsigned

このメンバーは、unsigned (char, short int, int, long long int)であることができるデータタイプと一緒にＣ変数のために使われます。bufferをさす変数がunsignedである場合、is_unsignedを真にセットし、そうでない場合には、虚にセットしてください。例えば、signed char変数をbufferに結びつける場合、MYSQL_TYPE_TINYのタイプコードを規定し、 is_unsignedを虚にセットしてください。代わりに、unsigned charを結びつける場合、タイプコードは同じですが、is_unsignedを真にすべきです。(charに対して、それがサインされるか否かが規定されないので、signed charまたはunsigned charを使って、サインについて明確にすることがベストです。)

is_unsignedはクライアント側のＣ言語変数だけに適用されます。それはクライアント側の対応するSQL値に対するサインの必要性に付いて何も示しません｡例えば、intを使ってBIGINT UNSIGNEDカラムのために値を供給する場合、intはサインするタイプなので、is_unsignedを虚にすべきです。unsigned intを使ってBIGINTカラムのために値を供給する場合、unsigned intはサインするタイプなので、is_unsignedを真にすべきです。MySQLは、結果が切り捨てられる場合警告が起こりますが、サイン済みの値と未サインの値の間の変換を両方向に実施します。

my_bool *error

アウトプットに対して、このメンバーをmy_bool変数をさして、列をフェッチした後、そこに記憶されたパラメータに対する切り捨て情報を持たせてください。(切り捨て報告はデフォルトによって有効化されますが、MYSQL_REPORT_DATA_TRUNCATIONオプションを使って、mysql_options()を呼び出すことによって、これを制御することができます。)切り捨て報告を有効化するとき、mysql_stmt_fetch()はMYSQL_DATA_TRUNCATEDを戻し、*errorは、その中で切り捨てが起こるMYSQL_BIND構造中で真となります。切り捨ては、サインまたは重要な桁の喪失あるいは、ストリングはコラムに収めるには長すぎたことを示します。