MYSQL

この構造体は、1 つのデータベース接続へのハンドルを表す。ほとんどの MySQL 関数で使用される。

MYSQL_RES

この構造体は、レコードを返すクエリ（SELECT、SHOW、EXPLAIN、DESCRIBE）の結果を表す。このセクションでは、クエリから返された情報を結果セットと呼ぶ。

MYSQL_ROW

1 行のデータのタイプセーフな表現。現在は、バイト文字列の配列として実装されている（フィールドにはバイナリデータが格納される場合があり、そのようなデータでは内部的にヌルバイトが使用される可能性があるので、バイト文字列をヌル終端文字列として扱うことはできない）。レコードを取得するには、mysql_fetch_row() を呼び出す。

MYSQL_FIELD

この構造体には、フィールドの名前、型、サイズなど、フィールドに関する情報が格納される。メンバの詳細については、以下で説明する。 各フィールドに対して mysql_fetch_field() を繰り返し呼び出すことによって、対応する MYSQL_FIELD 構造体を取得できる。フィールド値はこの構造体の一部ではなく、MYSQL_ROW 構造体に含まれる。

MYSQL_FIELD_OFFSET

MySQL フィールド一覧に対するオフセットの安全な型表現（mysql_field_seek() が使用）。オフセットはレコード内部でのフィールド番号であり、0 から始まる。

my_ulonglong

レコードの数を表すための型であり、mysql_affected_rows()、mysql_num_rows()、および mysql_insert_id() で使用される。0 から 1.84e19 までの範囲の値を表す。

一部のシステムでは、my_ulonglong 型の値を出力しようとしても、正常に出力されない。この型の値を出力するには、unsigned long に変換して、%lu フォーマットを使用する。以下に例を示す。

printf ("Number of rows: %lu\n", (unsigned long) mysql_num_rows(result));

char * name

フィールドの名前。ヌル終端文字列。

char * table

このフィールドが計算結果データのフィールドでない場合、このフィールドが属するテーブルの名前。計算結果データのフィールドの場合、table の値は空文字列になる。

char * def

このフィールドのデフォルト値。ヌル終端文字列。mysql_list_fields() を使用するときだけ設定される。

enum enum_field_types type

フィールドの型。 type の値は次のいずれかになる。

IS_NUM() マクロを使用すると、フィールドが数値型かどうかを調べることができる。type の値を IS_NUM() に渡すと、フィールドが数値型の場合は TRUE と評価される。

if (IS_NUM(field->type))
    printf("Field is numeric\n");

unsigned int length

フィールドの幅。テーブル定義で指定された値に従う。

unsigned int max_length

結果セットのフィールドの最大幅（結果セットに実際に存在するレコードのフィールド値の最大長）。mysql_store_result() または mysql_list_fields() を使用した場合、この値はフィールドの最大長を表す。mysql_use_result() を使用した場合、この値は 0 になる。

unsigned int flags

フィールドのさまざまな状態を表すビットフラグ。flags 値は、0 または以下のビットが 1 つ以上設定された値になる。

BLOB_FLAG、ENUM_FLAG、SET_FLAG、および TIMESTAMP_FLAG の各フラグは、フィールドの属性ではなく型を示しているので、廃止されている。代わりに、field->type を FIELD_TYPE_BLOB、FIELD_TYPE_ENUM、FIELD_TYPE_SET、または FIELD_TYPE_TIMESTAMP と比較する方が望ましい。

次に、flags 値の典型的な使用例を示す。

if (field->flags & NOT_NULL_FLAG)
    printf("Field can't be null\n");

以下のマクロを使用すると、flags 値を調べてブール値で結果を得ることができる。

unsigned int decimals

数値フィールドの小数部桁数。