C言語+MySQL入門|SELECTの結果が届くまで

C言語+MySQL入門|SELECTの結果が届くまで
第5章では、C言語からSQLを実行し、商品の登録・変更・削除を行いました。また、SQLの実行結果や影響を受けた行数を確認し、エラーが起きた場合の処理も学びましたね。
今回は、SELECTで取得した商品情報を、Cプログラムで受け取る流れを確認します。
SELECTでは、実行に成功したことを確認するだけでなく、返された結果を受け取り、1行ずつ取り出して利用する処理が必要になります。
この記事では、次の内容を学びます。
- SELECTによって返される行と列の関係
- Cプログラム、Connector/C、MySQL Serverの役割
- SQLの実行と、取得結果の受け取りの違い
- 取得結果全体と、1行分のデータの扱い方
- 商品情報を表示するプログラムの全体像
- 取得結果の解放と、接続を閉じる順序
この記事の到達点は、SELECTの実行から、結果の受け取り・表示・後片付けまでの流れを説明できることです。
新しい型や関数が登場しますが、それぞれの詳しい使い方は次の記事から順に扱います。まずは、商品情報がどのような道筋でCプログラムへ届くのかを見ていきましょう。
SELECTでは行と列のデータを受け取る
第5章で使ったINSERT、UPDATE、DELETEでは、主にSQLの成功・失敗と、影響を受けた行数を確認していました。
SELECTでは、それらとは異なり、検索したデータを受け取って利用します。
| SQL | 主な目的 | 実行後に確認・利用する情報 |
|---|---|---|
| INSERT | 商品を登録する | 成功・失敗、登録された行数、自動採番されたID |
| UPDATE | 商品情報を変更する | 成功・失敗、変更された行数 |
| DELETE | 商品を削除する | 成功・失敗、削除された行数 |
| SELECT | 商品情報を取得する | 成功・失敗、取得した行と列の値 |
たとえば、商品一覧を表示する場合には、商品ID、商品名、単価、在庫数などが必要です。
SELECTを実行すると、MySQL Serverは、指定された列や検索条件に従って結果を返します。Cプログラムは、その結果から必要な値を取り出し、画面へ表示します。
SQLが成功したことと、取得した商品情報を表示できたことは、別々に確認しましょう。
CプログラムとMySQL Serverの役割を確認しよう
商品一覧を取得するときも、SQLを実行するのはMySQL Serverです。
Cプログラムは、SQLを文字列として用意し、MariaDB Connector/Cの関数を呼び出します。Connector/Cがサーバーとの通信を担当し、取得結果をCプログラムから扱える形で提供します。
| 構成要素 | 商品一覧を取得するときの役割 |
|---|---|
| Cプログラム | SELECTを用意し、取得した値を表示する |
| MariaDB Connector/C | SQLの送信や結果の受信を行い、操作用の関数を提供する |
| MySQL Server | SELECTを実行し、取得結果を返す |
| products | 商品情報を保存しているテーブル |
MySQLクライアントでは、SELECTを入力すると、取得結果が文字の表として表示されていました。
しかし、自作するCプログラムでは、表の表示まで自動で行われるわけではありません。
取得結果を受け取る処理と、その内容をprintfなどで表示する処理を、自分で記述していきます。
図1:SELECTの要求と商品データが往復する流れ

この図から分かること
CプログラムがSELECTの実行を依頼すると、MySQL Serverが商品情報を取得します。
Connector/Cは、その間の通信と、結果を扱うための機能を提供します。受け取った商品情報をどのように表示するかは、Cプログラム側で決めます。
商品一覧を取得するSELECTを用意する
今回は、第3章で作成したproductsから、次の4つの列を取得します。
- 商品IDを表すproduct_id
- 商品名を表すproduct_name
- 単価を表すprice
- 在庫数を表すstock
MySQLクライアントで実行するSQLは、次のとおりです。
SELECT product_id, product_name, price, stock
FROM products
ORDER BY product_id;それぞれの指定を確認してみましょう。
| SQLの部分 | 役割 |
|---|---|
| SELECT product_id, product_name, price, stock | 取得する列と、その並び順を指定する |
| FROM products | 取得元のテーブルを指定する |
| ORDER BY product_id | 商品IDの昇順に結果を並べる |
今回はWHEREを指定していないため、productsにあるすべての商品が取得対象になります。
第5章で操作した商品IDが7の商品が削除済みでも、ほかの商品が残っていれば、それらを取得できます。
また、ORDER BYによる指定がない場合、表示される行の順序は保証されません。 商品ID順に表示したいときは、SQLにその指定を書いておきましょう。
取得結果は行と列の組み合わせになる
第3章の初期データが残っている場合、SELECTの結果は、たとえば次のようになります。
+------------+-----------------------+--------+-------+
| product_id | product_name | price | stock |
+------------+-----------------------+--------+-------+
| 1 | ノート | 180.00 | 0 |
| 2 | ボールペン | 120.00 | 0 |
| 3 | クリアファイル | 90.00 | 0 |
+------------+-----------------------+--------+-------+
3 rows in set (0.00 sec)この結果には、3行と4列があります。
| 数えるもの | この例での数 | 意味 |
|---|---|---|
| 行 | 3 | 取得した商品が3件ある |
| 列 | 4 | 1件の商品について、4つの値を取得している |
行は1件分のデータ、列はそのデータの項目を表します。
今回は、1行が1件の商品に対応しています。その行の中に、商品ID、商品名、単価、在庫数が並んでいます。
なお、取得結果の列は、productsのすべての列ではありません。登録日時のcreated_atは、今回のSELECTには指定していないため、結果に含まれません。
取得結果の列は、SELECTで指定した内容によって決まります。
SQLの実行と結果の受け取りを分けて考える
SELECTを実行するときも、最初に使うのはmysql_query()です。
第5章と同じように、戻り値が0ならSQLの実行成功、0以外なら失敗として扱います。戻り値そのものに、商品一覧や取得件数が入っているわけではありません。
SELECTに成功したら、続いてmysql_store_result()で結果を受け取ります。
| 処理 | 使用する関数 | 確認すること |
|---|---|---|
| SELECTを実行する | mysql_query() | SQLの実行に成功したか |
| 取得結果を受け取る | mysql_store_result() | 結果を受け取って保持できたか |
| 取得件数を調べる | mysql_num_rows() | 結果に何行あるか |
| 1行分を取り出す | mysql_fetch_row() | 次の行があるか |
mysql_store_result()は、取得結果をCプログラム側のメモリにまとめて保持するための関数です。受け取った結果は、MYSQL_RES型の情報として管理されます。MariaDB Documentation
ここで覚えておきたいのは、次の2つの確認です。
- mysql_query()の戻り値で、SQLの実行結果を確認する。
- mysql_store_result()の戻り値で、取得結果を受け取れたか確認する。
SELECTの実行に成功しても、その後の結果受信やメモリ確保に失敗する可能性があります。
そのため、mysql_query()が成功しただけで、結果の受け取りまで成功したと判断しないようにしましょう。
接続、取得結果全体、1行分のデータを区別する
SELECTの処理では、接続に加えて、取得結果を扱うための型が登場します。
| 型・変数 | 表しているもの | 主な用途 |
|---|---|---|
| MYSQL *conn | 接続ハンドル | SQLの実行やエラー確認 |
| MYSQL_RES *result | 取得結果全体を扱うためのポインタ | 件数確認や行の取り出し |
| MYSQL_ROW row | 取り出した1行の列を参照するための値 | 商品IDや商品名などの参照 |
connとresultは、別のものです。
connは、MySQL Serverとの接続を扱います。resultは、その接続で実行したSELECTの取得結果を扱います。
さらに、rowは結果全体ではなく、取り出した1行の各列を参照するために使います。MYSQL_ROWは、各列の値を指す文字ポインタの配列として扱われます。
まずは、次のように対応させてみてください。
- connで、接続を使う。
- resultで、取得結果全体を扱う。
- rowで、1行分の値を見る。
図2:取得結果全体を保持してから1行ずつ取り出す

この図から分かること
今回の方法では、mysql_store_result()で結果をまとめて受け取り、Cプログラム側に保持します。
その後、mysql_fetch_row()で、保持済みの結果から1行ずつ取り出します。行を取り出すたびに、新しいSELECTをサーバーへ送るわけではありません。
接続から後片付けまでの順序を確認する
商品一覧を表示するプログラムは、次の順序で進みます。
| 順番 | 処理 | 使用する関数など |
|---|---|---|
| 1 | 接続ハンドルを初期化する | mysql_init() |
| 2 | MySQL Serverへ接続する | mysql_real_connect() |
| 3 | 接続の文字セットを設定する | mysql_set_character_set() |
| 4 | SELECTを実行する | mysql_query() |
| 5 | 取得結果をまとめて受け取る | mysql_store_result() |
| 6 | 取得件数を確認する | mysql_num_rows() |
| 7 | 1行ずつ取り出して表示する | mysql_fetch_row()、printf() |
| 8 | 取得結果を解放する | mysql_free_result() |
| 9 | 接続を閉じる | mysql_close() |
第5章のプログラムと比べると、結果の受け取り、行の取り出し、取得結果の解放が追加されています。
それぞれの役割を分けると、全体の流れが分かりやすくなりますね。
実行前に学習環境を確認する
今回は、既存の商品データを取得するだけです。商品を追加・変更・削除する処理は行いません。
次の準備ができていることを確認しましょう。
- MySQL84サービスが起動している。
- inventory_dbが作成されている。
- productsが、第3章で示した定義になっている。
- inventory_userで接続できる。
- inventory_userに、productsのSELECT権限がある。
- MSYS2 UCRT64からConnector/Cを使ってビルドできる。
接続設定は、第4章・第5章と同じです。
| 項目 | 今回の設定 |
|---|---|
| ホスト | 127.0.0.1 |
| ポート番号 | 3306 |
| ユーザー名 | inventory_user |
| パスワードの例 | InventoryPass_2026 |
| データベース名 | inventory_db |
| ソースファイルの保存先 | C:\c-mysql\chap06 |
パスワードを変更している場合は、実際に設定した値をプログラムへ指定してください。
MySQLクライアントで現在の商品を確認する
先に、取得する商品データを確認しておきましょう。
Windowsのコマンドプロンプトで、次を実行します。
chcp 65001
cd /d "C:\Program Files\MySQL\MySQL Server 8.4\bin"
mysql --protocol=TCP --default-character-set=utf8mb4 -h 127.0.0.1 -P 3306 -u inventory_user -pパスワードを入力し、mysql>が表示されたら、次のSQLを実行します。
USE inventory_db;
SELECT product_id, product_name, price, stock
FROM products
ORDER BY product_id;ここに表示された商品が、Cプログラムでも取得する対象です。
+------------+-----------------------+--------+-------+
| product_id | product_name | price | stock |
+------------+-----------------------+--------+-------+
| 1 | ノート | 180.00 | 0 |
| 2 | ボールペン | 120.00 | 0 |
| 3 | クリアファイル | 90.00 | 0 |
+------------+-----------------------+--------+-------+
3 rows in set (0.00 sec)第5章で登録した商品が残っている場合、その商品も表示されます。例と件数が違っていても、現在のデータに対応していれば問題ありません。
表示例に合わせるために、データベースを初期化する必要はありません。
SELECTの結果を受け取るプログラムを作る
ここまでの流れを、1つのプログラムで確認してみましょう。
VS Codeで、C:\c-mysql\chap06に次のファイルを作成し、UTF-8で保存します。
今回は、商品情報を1行ずつ表示する簡単な形式にします。表の整形や数値への変換は、後の記事で詳しく扱います。
商品一覧を取得し、行ごとに表示して後片付けするプログラム
ファイル名: select_result_flow.c
#include <stdio.h>
#include <stdlib.h>
#include <mysql.h>
/* 接続ハンドルが有効なうちに、エラー情報を表示する */
static void print_mysql_error(
MYSQL *conn,
const char *operation
)
{
unsigned int error_number = mysql_errno(conn);
const char *sqlstate = mysql_sqlstate(conn);
const char *error_message = mysql_error(conn);
/* 通常の表示を出力してから、エラーを表示する */
fflush(stdout);
fprintf(stderr, "%s failed.\n", operation);
fprintf(stderr, "Error number: %u\n", error_number);
fprintf(stderr, "SQLSTATE: %s\n", sqlstate);
fprintf(stderr, "Message: %s\n", error_message);
}
int main(void)
{
/* 第3章で準備した接続情報を指定する */
const char *host = "127.0.0.1";
const char *user = "inventory_user";
/* 実際に設定したパスワードに合わせる */
const char *password = "InventoryPass_2026";
const char *database = "inventory_db";
unsigned int port = 3306;
/* 接続ハンドルを確保して初期化する */
MYSQL *conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "mysql_init() failed.\n");
return EXIT_FAILURE;
}
/* MySQL Serverへ接続する */
if (mysql_real_connect(
conn,
host,
user,
password,
database,
port,
NULL,
0
) == NULL) {
print_mysql_error(conn, "Connection");
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
puts("Connected to MySQL Server.");
/* 日本語の商品名をUTF-8で受け取るために設定する */
if (mysql_set_character_set(conn, "utf8mb4") != 0) {
print_mysql_error(conn, "Character set setup");
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
puts("Connection character set: utf8mb4");
/* 取得する4列と、商品ID順の並びを指定する */
const char *sql =
"SELECT product_id, product_name, price, stock "
"FROM products "
"ORDER BY product_id";
printf("SQL: %s\n", sql);
puts("Executing SELECT...");
/* まず、SELECTの実行に成功したか確認する */
int query_result = mysql_query(conn, sql);
if (query_result != 0) {
print_mysql_error(conn, "SELECT");
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
printf("mysql_query() returned: %d\n", query_result);
/* 取得結果全体を、Cプログラム側のメモリに保持する */
MYSQL_RES *result = mysql_store_result(conn);
/*
* 今回のSELECTは、結果セットを返すSQL。
* NULLの場合は、結果の受け取りに失敗したとして扱う。
*/
if (result == NULL) {
print_mysql_error(conn, "Result retrieval");
mysql_close(conn);
conn = NULL;
return EXIT_FAILURE;
}
puts("Result set received.");
/* 受け取った結果に含まれる行数を取得する */
my_ulonglong row_count = mysql_num_rows(result);
printf(
"Product rows: %llu\n",
(unsigned long long)row_count
);
if (row_count == 0) {
puts("No products found.");
} else {
puts("Products:");
}
/* 1行分のデータを参照するための変数 */
MYSQL_ROW row = NULL;
/* 保持した結果から、次の行がなくなるまで取り出す */
while ((row = mysql_fetch_row(result)) != NULL) {
/*
* 列の順序は、SELECTに書いた順序と対応する。
* NULLの列を、そのまま文字列として表示しない。
*/
const char *product_id =
(row[0] != NULL) ? row[0] : "(NULL)";
const char *product_name =
(row[1] != NULL) ? row[1] : "(NULL)";
const char *price =
(row[2] != NULL) ? row[2] : "(NULL)";
const char *stock =
(row[3] != NULL) ? row[3] : "(NULL)";
/* 今回は、すべての列を文字列として表示する */
printf(
"ID=%s | Name=%s | Price=%s | Stock=%s\n",
product_id,
product_name,
price,
stock
);
}
/* 取得結果が不要になったので、メモリを解放する */
mysql_free_result(result);
result = NULL;
puts("Result set released.");
/* 取得結果の後片付けを終えてから、接続を閉じる */
mysql_close(conn);
conn = NULL;
puts("Connection closed.");
return EXIT_SUCCESS;
}#include <mysql.h>のincludePathエラーが出る場合
以下の記事を参考にしてください。
プログラムの処理を順番に確認する
接続と文字セットの設定を引き継ぐ
接続ハンドルの初期化、MySQL Serverへの接続、文字セットの設定は、第5章と同じ流れです。
今回も、接続や文字セットの設定に失敗した場合は、SELECTへ進まずに終了します。
| 処理 | 成功後に行うこと | 失敗した場合 |
|---|---|---|
| mysql_init() | 接続を試みる | 固定メッセージを表示して終了する |
| mysql_real_connect() | 文字セットを設定する | エラーを表示し、ハンドルを解放する |
| mysql_set_character_set() | SELECTを実行する | エラーを表示し、接続を閉じる |
日本語の商品名を扱うため、接続の文字セットにはutf8mb4を指定しています。
ソースファイルをUTF-8で保存することと、接続の文字セットを設定することを、引き続きセットで確認してください。
mysql_query()でSELECTを実行する
sqlには、商品一覧を取得する固定SQLを保存しています。
複数行に分けて書いたC言語の文字列リテラルは、1つの文字列としてつながります。FROMやORDER BYの前には、必要な空白が入るようにしています。
mysql_query()の戻り値は、query_resultへ保存します。
| query_result | プログラムの処理 |
|---|---|
| 0 | 取得結果の受け取りへ進む |
| 0以外 | エラーを表示し、接続を閉じて終了する |
ここで確認できるのは、SELECTの実行に成功したことです。商品情報の表示は、まだ行っていません。
mysql_store_result()で取得結果を保持する
SELECTの実行に成功した後、mysql_store_result()を呼び出します。
戻り値は、MYSQL_RES *型の変数resultへ保存します。
今回のSQLは、結果セットを返すSELECTです。そのため、resultがNULLなら、結果の受け取りに失敗したとして処理します。
なお、mysql_store_result()は、INSERTなどの結果セットを返さないSQLでもNULLを返します。NULLが何を意味するかは、実行したSQLと合わせて判断する必要があります。 詳しい判定方法は、次の記事で確認します。
mysql_fetch_row()で1行ずつ取り出す
取得結果を受け取れたら、mysql_fetch_row()で1行ずつ取り出します。
今回のようにmysql_store_result()で結果を保持した場合、mysql_fetch_row()は、次の行があればその行を返し、取り出す行がなくなるとNULLを返します。
whileの条件では、次の処理を続けて行っています。
- mysql_fetch_row()で次の1行を取り出す。
- 戻り値をrowへ保存する。
- rowがNULLではないか確認する。
- 行があれば、whileの中で表示する。
- 行がなくなれば、繰り返しを終える。
rowへの代入に使っている=と、NULLとの比較に使っている!=は、それぞれ役割が異なります。
SELECTの列順とrowの番号を対応させる
1行分の列は、0から始まる番号で参照します。
今回の対応は、次のとおりです。
| SELECTでの順序 | rowでの参照 | 取得する値 |
|---|---|---|
| 1番目 | row[0] | product_id |
| 2番目 | row[1] | product_name |
| 3番目 | row[2] | price |
| 4番目 | row[3] | stock |
列番号は、productsの定義上の順序ではなく、今回のSELECTで指定した順序に対応します。
SELECTの列の並びを変更すると、rowの番号と値の対応も変わります。
また、今回の方法では、数値列も文字列として参照して表示しています。product_idはデータベース上ではINTですが、取得した値をそのままCのintとして計算に使えるわけではありません。
数値として利用するための変換は、6.9で詳しく扱います。
NULLを確認してから文字列を表示する
コードでは、各列がNULLではないか確認し、NULLなら表示用の文字列に置き換えています。
| 記述 | 意味 |
|---|---|
| row[0] != NULL | 列の値を指すポインタがあるか確認する |
| 条件 ? 値1 : 値2 | 条件が成り立つなら値1、成り立たないなら値2を選ぶ |
| "(NULL)" | 値がNULLだった場合に表示する文字列 |
今回取得するproductsの4列は、第3章でNOT NULLにしています。その定義どおりなら、SQLのNULLは含まれません。
ただし、後の記事で別のSELECTを使う場合に備え、NULLをそのまま%sへ渡さない書き方にしています。NULLの扱いは、6.8で詳しく確認しましょう。
UCRT64でビルドする
MSYS2 UCRT64のターミナルを開き、保存先へ移動します。
cd /c/c-mysql/chap06WindowsのC:\c-mysql\chap06は、MSYS2からは/c/c-mysql/chap06として参照できます。
簡潔なコマンドでビルドする
gcc select_result_flow.c -o select_result_flow.exe \
$(pkg-config --cflags --libs mysqlclient)C17と警告オプションを指定してビルドする
gcc -std=c17 -Wall -Wextra -Wpedantic \
select_result_flow.c -o select_result_flow.exe \
$(pkg-config --cflags --libs mysqlclient)| 指定 | 役割 |
|---|---|
| -std=c17 | C17を指定する |
| -Wall -Wextra -Wpedantic | 警告を有効にする |
| select_result_flow.c | ビルドするソースファイル |
| -o select_result_flow.exe | 作成する実行ファイル名を指定する |
| pkg-config --cflags --libs mysqlclient | Connector/Cのコンパイル・リンク設定を取得する |
GCCのエラーがなく、ビルドに成功したことを確認してから実行します。
実行して商品一覧を確認する
UCRT64のターミナルで、次を実行します。
./select_result_flow.exe実行結果の例
第3章の初期データ3件が残っている場合の例です。
Connected to MySQL Server.
Connection character set: utf8mb4
SQL: SELECT product_id, product_name, price, stock FROM products ORDER BY product_id
Executing SELECT...
mysql_query() returned: 0
Result set received.
Product rows: 3
Products:
ID=1 | Name=ノート | Price=180.00 | Stock=0
ID=2 | Name=ボールペン | Price=120.00 | Stock=0
ID=3 | Name=クリアファイル | Price=90.00 | Stock=0
Result set released.
Connection closed.商品の件数や値は、現在のproductsの内容によって変わります。
第5章で登録したエラー確認用商品などが残っている場合は、その商品も表示されます。
| 表示 | 分かること |
|---|---|
| Connected to MySQL Server. | 接続に成功した |
| mysql_query() returned: 0 | SELECTの実行に成功した |
| Result set received. | 取得結果を受け取れた |
| Product rows: 3 | 取得結果に3行ある |
| ID=から始まる各行 | 1行分の商品情報を取り出して表示した |
| Result set released. | 取得結果を解放した後の処理へ進んだ |
| Connection closed. | 接続を閉じた後の処理へ進んだ |
MySQLクライアントで確認した商品と、Cプログラムに表示された商品を見比べてみてください。
確認の間に別の操作で商品が変更されていなければ、同じSELECTに対応した商品情報を確認できます。
終了ステータスも確認する
プログラムの実行直後に、次を入力します。
echo $?正常終了した場合、今回の環境では0が表示されます。
0echo $?は、直前に実行したコマンドの終了ステータスを表示します。プログラムを実行した直後に確認しましょう。
商品が0件でも、SELECTは成功する
productsに商品がない場合でも、SELECTを正常に実行できることがあります。
この場合、受け取るのは、行数が0の結果セットです。
商品が0件であることと、結果の受け取りに失敗したことは、同じではありません。 正常に受け取った空の結果セットと、mysql_store_result()が返すNULLを区別しましょう。
| 状況 | mysql_query() | mysql_store_result() | 取得結果 |
|---|---|---|---|
| 商品がある | 成功なら0 | 成功なら有効なポインタ | 1行以上 |
| 商品がない | 成功なら0 | 成功なら有効なポインタ | 0行 |
| SELECTの実行に失敗 | 0以外 | 今回のコードでは呼び出さない | 利用しない |
| SELECT成功後、結果受信などに失敗 | 0 | NULL | 利用できない |
商品がない場合の表示は、次のようになります。
Connected to MySQL Server.
Connection character set: utf8mb4
SQL: SELECT product_id, product_name, price, stock FROM products ORDER BY product_id
Executing SELECT...
mysql_query() returned: 0
Result set received.
Product rows: 0
No products found.
Result set released.
Connection closed.行が0件なので、mysql_fetch_row()は最初の呼び出しでNULLを返し、whileの中には入りません。
それでも、取得した結果セットの解放は必要です。
この表示を試すために、現在の商品をすべて削除する必要はありません。まずは、0件も正常な検索結果の1つであることを押さえておきましょう。
取得結果と接続は、それぞれ後片付けする
商品情報を表示し終えたら、mysql_free_result()で取得結果を解放します。
その後、mysql_close()で接続を閉じます。
| 後片付け | 対象 | 主な役割 |
|---|---|---|
| mysql_free_result(result) | 取得結果 | 結果のために使っていたメモリを解放する |
| mysql_close(conn) | 接続ハンドル | 接続を閉じ、ハンドルの資源を解放する |
mysql_free_result()を呼んでも、productsの商品が削除されるわけではありません。
解放するのは、Cプログラム側で保持していた取得結果です。データベースに保存されている商品は、そのまま残ります。
また、mysql_free_result()の後は、その結果から取得したrowや列の値を利用できません。必要な表示や処理を終えてから解放しましょう。
resultへNULLを代入することと、取得結果を解放することも別です。
- mysql_free_result(result)が、取得結果を解放する。
- result = NULLが、変数resultへNULLを代入する。
第4章で学んだmysql_close()とconn = NULLの関係と、同じように考えられますね。
図3:取得結果を使い終えてから解放し、接続を閉じる

この図から分かること
取得結果を利用する処理が終わったら、その結果を解放します。今回のプログラムでは、その後に接続を閉じます。
結果の解放は、Cプログラム側のメモリを片付ける処理です。MySQL Serverに保存された商品を削除する操作ではありません。
失敗した段階に合わせて処理を止める
今回も、失敗した場所によって後片付けが変わります。
| 失敗した場所 | その時点で持っているもの | 終了前に行うこと |
|---|---|---|
| 接続ハンドルの初期化 | 有効な接続ハンドルはない | 固定メッセージを表示する |
| サーバーへの接続 | 初期化済みの接続ハンドル | エラーを表示し、ハンドルを解放する |
| 文字セットの設定 | 接続済みのハンドル | エラーを表示し、接続を閉じる |
| SELECTの実行 | 接続済みのハンドル | エラーを表示し、接続を閉じる |
| 取得結果の受け取り | 接続済みのハンドル。結果は取得できていない | エラーを表示し、接続を閉じる |
mysql_store_result()がNULLを返した場合、そのNULLをmysql_num_rows()やmysql_fetch_row()へ渡してはいけません。
コードでは、その場でエラー処理へ進むため、利用できない結果を使わずに終了できます。
また、第5章のexecute_change_sql()は、結果の行を受け取らないSQLを扱うための関数でした。SELECTには、そのまま流用せず、今回のように結果を受け取る処理を用意します。
次はmysql_store_result()の使い方を詳しく確認しよう
今回は、SELECTを実行して結果を受け取り、1行ずつ表示した後、取得結果と接続を片付ける流れを確認しました。
次の記事では、この中のmysql_store_result()に注目します。
接続ハンドルから取得結果を受け取る方法と、戻り値がNULLだった場合の考え方を、もう少し詳しく見ていきましょう。










