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/CSQLの送信や結果の受信を行い、操作用の関数を提供する
MySQL ServerSELECTを実行し、取得結果を返す
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件ある
列41件の商品について、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()
2MySQL Serverへ接続するmysql_real_connect()
3接続の文字セットを設定するmysql_set_character_set()
4SELECTを実行するmysql_query()
5取得結果をまとめて受け取るmysql_store_result()
6取得件数を確認するmysql_num_rows()
71行ずつ取り出して表示する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エラーが出る場合

以下の記事を参考にしてください。

VS CodeでGTK 4とMySQLのincludePathを設定しよう

VS CodeでGTK 4とMySQLのincludePathを設定しよう C言語でGTK 4やMySQLを利用するプログラムを書いていると、VS Codeで次のようなコードに赤い波線が表示されることがあり…

プログラムの処理を順番に確認する

接続と文字セットの設定を引き継ぐ

接続ハンドルの初期化、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の条件では、次の処理を続けて行っています。

  1. mysql_fetch_row()で次の1行を取り出す。
  2. 戻り値をrowへ保存する。
  3. rowがNULLではないか確認する。
  4. 行があれば、whileの中で表示する。
  5. 行がなくなれば、繰り返しを終える。

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/chap06

Windowsの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=c17C17を指定する
-Wall -Wextra -Wpedantic警告を有効にする
select_result_flow.cビルドするソースファイル
-o select_result_flow.exe作成する実行ファイル名を指定する
pkg-config --cflags --libs mysqlclientConnector/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: 0SELECTの実行に成功した
Result set received.取得結果を受け取れた
Product rows: 3取得結果に3行ある
ID=から始まる各行1行分の商品情報を取り出して表示した
Result set released.取得結果を解放した後の処理へ進んだ
Connection closed.接続を閉じた後の処理へ進んだ

MySQLクライアントで確認した商品と、Cプログラムに表示された商品を見比べてみてください。

確認の間に別の操作で商品が変更されていなければ、同じSELECTに対応した商品情報を確認できます。

終了ステータスも確認する

プログラムの実行直後に、次を入力します。

echo $?

正常終了した場合、今回の環境では0が表示されます。

0

echo $?は、直前に実行したコマンドの終了ステータスを表示します。プログラムを実行した直後に確認しましょう。

商品が0件でも、SELECTは成功する

productsに商品がない場合でも、SELECTを正常に実行できることがあります。

この場合、受け取るのは、行数が0の結果セットです。

商品が0件であることと、結果の受け取りに失敗したことは、同じではありません。 正常に受け取った空の結果セットと、mysql_store_result()が返すNULLを区別しましょう。

状況mysql_query()mysql_store_result()取得結果
商品がある成功なら0成功なら有効なポインタ1行以上
商品がない成功なら0成功なら有効なポインタ0行
SELECTの実行に失敗0以外今回のコードでは呼び出さない利用しない
SELECT成功後、結果受信などに失敗0NULL利用できない

商品がない場合の表示は、次のようになります。

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だった場合の考え方を、もう少し詳しく見ていきましょう。

Follow me!