C言語+MySQL入門|完成するコンソールアプリを確認する

C言語+MySQL入門|完成するコンソールアプリを確認する

第9章までは、C言語からMySQLへ接続し、商品情報の登録・取得・変更・削除や、在庫数と履歴をまとめて更新する方法を学びました。また、接続設定、アプリ用ユーザーの権限、入力値の検証、エラーの伝え方も整理してきましたね。

第10章では、これらの処理を組み合わせる前に、コンソール版在庫管理アプリの設計を進めます。

最初に確認するのは、完成したアプリを、利用者がどのような順序で操作するのかです。

この記事では、次の内容を見ていきます。

  • 完成するコンソールアプリのメニュー
  • 商品登録から入庫・出庫・履歴表示までの操作例
  • 商品情報の変更と削除の扱い
  • 入力エラーや在庫不足が起きたときの動作
  • アプリを起動してから終了するまでの流れ
  • 完成イメージを表示するCプログラム

ここで示す操作画面は、これから実装するアプリの表示案です。第10章では仕様を整理し、第11章と第12章で実際に動くアプリへ組み立てていきます。

これまで作った処理を一つのアプリにつなげよう

これまでの学習では、商品を登録するプログラムや、入出庫を行うプログラムなどを、目的ごとに作成してきました。

コンソール版では、これらの操作を一つのメニューから選べるようにします。

利用者が毎回別のプログラムを起動したり、SQLを入力したりする必要はありません。アプリを起動し、番号を選び、必要な情報を入力することで操作できる形を目指します。

完成するアプリの機能利用者が行うこと
商品登録商品名と単価を入力する
商品一覧登録済みの商品と在庫数を確認する
商品情報の変更商品IDを指定し、商品名や単価を変更する
商品削除商品IDを指定し、削除できる商品を削除する
入庫商品IDと数量を指定し、在庫を増やす
出庫商品IDと数量を指定し、在庫を減らす
在庫履歴の表示指定した商品の入出庫記録を確認する
終了接続などを片付けてアプリを終了する

商品IDによる検索は、変更・削除・入出庫などで対象の商品を確認するためにも使用します。今回のメニューでは、独立した検索項目を増やさず、それぞれの操作の中で対象を確認する形にします。

完成するメニューを確認しよう

第1章で紹介した完成イメージを引き継ぎ、次のメニューを使います。

コンソール版在庫管理アプリのメニュー表示案

在庫管理アプリ

1. 商品を登録する
2. 商品を一覧表示する
3. 商品情報を変更する
4. 商品を削除する
5. 入庫する
6. 出庫する
7. 在庫履歴を表示する
0. 終了する

操作を選んでください:

利用者は、操作に対応する番号を入力します。

たとえば、商品を登録したい場合は1、入庫したい場合は5、終了したい場合は0を選びます。

入力する番号選択される操作
1商品登録
2商品一覧
3商品情報の変更
4商品削除
5入庫
6出庫
7在庫履歴の表示
0終了

メニュー番号と商品IDは、役割が異なります。

メニュー番号は、何をするかを選ぶための番号です。商品IDは、どの商品を操作するかを指定するための番号です。

たとえば、5を選んで入庫処理へ進んだ後、対象の商品IDとして101を入力する、という順序になります。

図1:メニューから必要な操作を選ぶ

この図から分かること

一つのメニューから、商品管理、入出庫、履歴表示を選べます。

操作の入り口をそろえることで、利用者は必要な機能を見つけやすくなります。また、一つの操作が終わったらメニューへ戻り、続けて別の操作を行えるようにします。

一つの操作が終わったらメニューへ戻る

完成するアプリは、商品を一件登録しただけでは終了しません。

登録後に一覧を表示したり、その商品を入庫したりできるよう、操作を繰り返せる構成にします。

基本的な流れは、次のとおりです。

  1. メニューを表示する。
  2. 操作番号を受け取る。
  3. 選択した操作に必要な情報を入力してもらう。
  4. 入力内容を確認し、DB処理を呼び出す。
  5. 処理結果を表示する。
  6. 次の操作を選べるよう、メニューへ戻る。

ただし、DBとの接続を失った場合など、処理を継続できない状態では別の対応が必要です。通常の入力間違いと、接続を使い続けられないエラーは分けて扱います。

まずは、正常に操作できる場面を順番に見ていきましょう。

商品を登録して一覧に表示しよう

ここからは、ノートを登録し、入庫・出庫を行う操作例を確認します。

説明では、次の商品を使用します。

項目操作例で使う値
商品名ノート
単価180.50
登録直後の在庫数0個
入庫する数量10個
出庫する数量3個

以下の表示例は、ほかの接続から同じ商品が操作されていない場合を想定しています。

商品登録の操作例

メニューで1を選び、商品名と単価を入力します。

操作を選んでください:1

商品名を入力してください:ノート
単価を入力してください:180.50

商品を登録しました。
商品ID:101
登録時の在庫数:0個

商品IDは、MySQLの自動採番によって決まります。101は説明用の番号なので、実際には登録結果として返された商品IDを使用します。

登録時に利用者が入力するのは、商品名と単価です。在庫数には、productsテーブルで設定済みの初期値0を使用します。

商品の登録と、商品の入庫は別の操作として扱います。

商品を登録しただけでは、入庫履歴は追加しません。在庫を増やすときに、入庫処理を行います。

商品一覧の表示例

続いて、メニューで2を選びます。

操作を選んでください:2

商品一覧

商品ID:101
商品名:ノート
単価:180.50
在庫数:0個

表示件数:1件

ここでは内容を読み取りやすいように、商品ごとの項目を縦に表示しています。一覧の整形方法は、後の記事で具体的に決めていきます。

一覧を取得できた結果が0件だった場合は、商品が登録されていないことを案内します。

登録されている商品はありません。

0件であることと、DBからの取得に失敗したことは区別します。

入庫して在庫と履歴を増やそう

メニューで5を選び、登録した商品を10個入庫します。

入庫の操作例

操作を選んでください:5

商品IDを入力してください:101

商品名:ノート
確認時点の在庫数:0個

入庫数量を入力してください:10

入庫が完了しました。
再取得した在庫数:10個

入庫では、次の二つの変更を行います。

  • productsの在庫数を10個増やす。
  • stock_historyへ、数量10のIN履歴を追加する。

第8章で学んだように、在庫更新と履歴登録は同じトランザクションで処理します。

データ入庫前入庫後
productsの在庫数010
今回の商品に関する履歴なしIN、数量10を追加

在庫の更新に成功しても、履歴の登録に失敗した場合は、そのまま入庫完了にはしません。途中までの変更を取り消す処理が必要になります。

また、在庫数の上限を超える入庫も受け付けない方針を引き継ぎます。

出庫して在庫を減らそう

続いて、メニューで6を選び、同じ商品を3個出庫します。

出庫の操作例

操作を選んでください:6

商品IDを入力してください:101

商品名:ノート
確認時点の在庫数:10個

出庫数量を入力してください:3

出庫が完了しました。
再取得した在庫数:7個

出庫では、次の二つの変更を行います。

  • productsの在庫数を3個減らす。
  • stock_historyへ、数量3のOUT履歴を追加する。

ここでも、二つの変更を同じトランザクションに含めます。

データ出庫前出庫後
productsの在庫数107
今回の商品に関する履歴IN、数量10OUT、数量3を追加

出庫数量は正の整数で入力します。履歴にも、負の数ではなく数量3として保存し、OUTによって出庫を表します。

画面の在庫数だけで出庫できると判断しない

商品を確認した後に、別の利用者が同じ商品を出庫する可能性があります。

そのため、画面に表示した在庫数からC側で引き算するだけでは、同時操作に対応できません。

実際の出庫では、第8章で作った処理を使い、更新時の在庫数が出庫数量以上である場合だけ、DB側で減算します。

操作後に再取得した在庫数も、その取得時点の値です。画面へ表示した数が、その後も変わらないという意味ではありません。

在庫履歴で入出庫の記録を確認しよう

メニューで7を選び、商品IDを指定して履歴を表示します。

在庫履歴の表示例

操作を選んでください:7

商品IDを入力してください:101

商品名:ノート
在庫履歴

履歴ID:501
記録日時:2026-10-24 14:10:00
種類:入庫
数量:10個

履歴ID:502
記録日時:2026-10-24 14:12:00
種類:出庫
数量:3個

表示件数:2件

履歴IDと日時は説明用の例です。

stock_historyでは、入庫をIN、出庫をOUTとして保存します。利用者向けの画面では、入庫・出庫という日本語へ置き換えると読み取りやすくなります。

保存される値画面での表示
IN入庫
OUT出庫

今回の例では、登録時の在庫数が0個で、その後に10個入庫し、3個出庫しています。

そのため、操作後の在庫数は7個になります。

ただし、履歴の各行には、その操作後の在庫数を保存していません。現在の在庫数を管理するproductsと、増減の記録を保存するstock_historyは、役割を分けて使います。

図2:商品登録から入出庫・履歴確認まで

この図から分かること

商品登録時の在庫数は0個です。その後、入庫で在庫が増え、出庫で減ります。

入庫と出庫を行うたびに、その数量と種類が履歴へ追加されます。在庫更新と履歴登録を一緒に確定することで、現在の在庫と増減の記録を対応させます。

完成イメージをCプログラムで表示してみよう

ここまで見てきたメニューと操作の流れを、短いCプログラムで表示してみましょう。

このプログラムは、固定の完成イメージを表示するだけの確認用プログラムです。

キーボード入力は受け付けず、MySQLへの接続や、商品の登録・在庫更新も行いません。画面に表示する内容を確認するために使います。

保存先は、C:\c-mysql\chap10とします。

メニューと一連の操作例を表示するプログラム

ファイル名: console_preview.c

#include <stdio.h>

/* 完成後に使うメニューの表示案を出力する */
static void print_menu(void)
{
    puts("在庫管理アプリ");
    putchar('\n');
    puts("1. 商品を登録する");
    puts("2. 商品を一覧表示する");
    puts("3. 商品情報を変更する");
    puts("4. 商品を削除する");
    puts("5. 入庫する");
    puts("6. 出庫する");
    puts("7. 在庫履歴を表示する");
    puts("0. 終了する");
    putchar('\n');
    puts("操作を選んでください:");
}

/* 実際には更新せず、一連の操作例を固定の文字列で表示する */
static void print_operation_example(void)
{
    puts("\n操作の流れの例");
    puts("商品登録:ノート、単価180.50、在庫0個");
    puts("入庫:10個を追加し、在庫10個、入庫履歴を1件追加");
    puts("出庫:3個を減らし、在庫7個、出庫履歴を1件追加");
    puts("履歴表示:入庫10個、出庫3個を確認");
    puts("在庫不足:8個の出庫は行わず、在庫7個のまま");
}

int main(void)
{
    /* このプログラムは入力やDB接続を行わない */
    puts("完成イメージを表示します。");
    puts("入力の受け付けや、MySQLへの接続・更新は行いません。");
    putchar('\n');

    print_menu();
    print_operation_example();

    return 0;
}

コンパイルして実行する

MSYS2 UCRT64のターミナルで、保存先へ移動します。

cd /c/c-mysql/chap10

まずは、簡潔なコンパイル方法です。

gcc console_preview.c -o console_preview.exe

C17と警告オプションを指定する場合は、次のコマンドを使います。

gcc -std=c17 -Wall -Wextra -Wpedantic console_preview.c -o console_preview.exe

作成したプログラムを実行します。

./console_preview.exe

今回使用するのはCの標準入出力だけなので、Connector/Cのビルド設定は必要ありません。

実行結果の例

完成イメージを表示します。
入力の受け付けや、MySQLへの接続・更新は行いません。

在庫管理アプリ

1. 商品を登録する
2. 商品を一覧表示する
3. 商品情報を変更する
4. 商品を削除する
5. 入庫する
6. 出庫する
7. 在庫履歴を表示する
0. 終了する

操作を選んでください:

操作の流れの例
商品登録:ノート、単価180.50、在庫0個
入庫:10個を追加し、在庫10個、入庫履歴を1件追加
出庫:3個を減らし、在庫7個、出庫履歴を1件追加
履歴表示:入庫10個、出庫3個を確認
在庫不足:8個の出庫は行わず、在庫7個のまま

操作を選んでくださいという表示はありますが、このプログラムは入力を待ちません。そのまま操作例を表示して終了します。

実際に番号を受け取り、処理を切り替える部分は、後の記事で作成します。

プログラムの処理を確認しよう

表示する内容を、二つの関数に分けています。

関数役割
print_menuメニューの表示案を出力する
print_operation_example商品登録から入出庫までの操作例を出力する
main説明を表示し、二つの表示関数を順番に呼び出す

putsは、文字列と、その後の改行を出力します。

putcharでは1文字を出力できます。今回は改行文字を出力し、表示の間に空行を入れています。

また、print_menuとprint_operation_exampleにはstaticを付けています。このソースファイルの中で使う関数として定義するためです。

この段階では、表示内容の確認が目的です。在庫数を計算したり、履歴を保存したりする処理は含めていません。

商品情報の変更と、在庫数の変更を分けよう

完成するアプリでは、商品名や単価の変更も行えます。

メニューで3を選び、商品IDで対象を確認してから、新しい情報を入力します。

商品情報を変更する操作例

操作を選んでください:3

商品IDを入力してください:101

現在の商品名:ノート
現在の単価:180.50

新しい商品名を入力してください:大学ノート
新しい単価を入力してください:200.00

商品情報を変更しました。

この操作で変更するのは、商品名と単価です。

在庫数を直接書き換える項目は設けません。在庫数を変える場合は、入庫または出庫を使います。

変更したい内容使用する操作
商品名商品情報の変更
単価商品情報の変更
在庫数を増やす入庫
在庫数を減らす出庫

在庫数を商品変更画面から自由に書き換えられるようにすると、入出庫履歴を残さずに数量が変わる可能性があります。

今回のアプリでは、在庫の増減を入出庫処理へ集めることで、履歴と対応させます。

なお、単価が変わらない値で更新した場合など、更新行数が0になるケースの読み分けは、商品変更の実装時に整理します。更新行数が0という情報だけで、商品が存在しないと決めつけないようにします。

商品を削除できる条件も画面へ反映しよう

メニューで4を選ぶと、商品の削除へ進みます。

ただし、商品IDが分かれば、どの商品でも削除できるわけではありません。

第3章と第5章で扱った方針を引き継ぎ、次の条件を満たす商品を削除対象とします。

  • 対象の商品が存在する。
  • 在庫数が0である。
  • その商品を参照する在庫履歴がない。

たとえば、先ほどの商品には7個の在庫が残っています。その状態では削除を行いません。

操作を選んでください:4

商品IDを入力してください:101

在庫が残っているため、削除できません。

また、後で在庫数が0になったとしても、入出庫履歴が残っていれば削除しません。

入出庫履歴があるため、削除できません。

画面で事前に確認するだけでなく、実際の削除でも在庫数の条件と外部キー制約を使ってルールを守ります。

削除が許可される場合は、対象の商品を表示し、利用者が確認してから実行する形にします。具体的な確認方法とDB処理の対応は、10.6で詳しく決めていきます。

正常に操作できない場合の動きも確認しよう

完成イメージを考えるときには、成功した画面だけでなく、操作を続けられなかった場合の動作も決めておきましょう。

状況利用者への案内と動作
存在しないメニュー番号選択できる番号を案内し、メニューを表示し直す
数量に数字以外が含まれる入力形式を案内し、その入力では更新しない
入出庫数量が01以上の数量を入力するよう案内する
単価の小数部分が3桁入力形式を案内し、登録・変更しない
商品が見つからない対象が見つからないことを伝える
出庫時に更新条件を満たさない在庫不足などの可能性を案内し、履歴を追加しない
DBへの接続に失敗する利用者向けの説明と確認コードを表示する
更新やCOMMITの結果を確認できない再操作を促さず、結果確認が必要であることを伝える

在庫が足りないときの表示例

在庫が7個の状態で、8個の出庫を要求した場合を考えてみましょう。

第8章の共通関数では、更新行数が0だった場合、商品が存在しない場合と在庫不足の場合を、更新行数だけでは区別しません。

そのため、共通関数の結果に合わせて、次のような案内が考えられます。

出庫数量を入力してください:8

商品が存在しないか、在庫が不足しているため、出庫できませんでした。
商品一覧を確認してください。

この例では商品が存在し、在庫不足によって更新されていません。在庫は7個のままで、新しい出庫履歴も追加されません。

利用者に示す説明は、DB処理から受け取った情報で判断できる範囲に合わせます。

結果が不明な操作を、すぐに繰り返さない

通信が切れた場合などには、更新やCOMMITが成功したか確認できないことがあります。

その状態で、もう一度出庫してくださいと案内すると、同じ出庫が二重に行われる可能性があります。

第8章で扱ったSTOCK_UNCERTAINのように、結果が不明な状態は通常の失敗と区別します。

処理結果を確認できませんでした。
同じ操作を繰り返さず、在庫と履歴の確認を依頼してください。

入力の間違いなら修正してやり直せますが、結果不明の場合には、先の操作が反映されたかを確認する必要があります。

図3:操作結果に合わせて次の行動を案内する

この図から分かること

操作の結果によって、利用者が次に行うことは変わります。

入力エラーでは入力内容を直し、更新条件を満たさなかった場合には商品や在庫を確認します。一方、処理結果が不明な場合は、同じ操作を繰り返す前に、在庫と履歴の確認が必要です。

起動から終了までを一つの流れで確認しよう

最後に、完成するアプリ全体の動きを確認しておきましょう。

段階アプリが行うこと
起動時接続設定を読み込み、内容を検証する
接続前パスワードを実行時に受け取る
接続時アプリ用ユーザーでMySQLへ接続する
操作中メニューから商品管理・入出庫・履歴表示を行う
操作後結果を表示し、継続可能であればメニューへ戻る
終了時使用中の資源とDB接続を片付ける

接続設定とパスワードの扱いは、第9章の方針を引き継ぎます。

  • inventory.confには、ホスト・ポート・DB名・ユーザー名を保存する。
  • パスワードは設定ファイルへ書かず、実行時に受け取る。
  • 接続にはinventory_userを使用する。
  • 接続に失敗した場合は、メニュー操作へ進まない。
  • エラー情報は必要な項目を保存し、利用者向けの説明と分けて扱う。

正常に終了するときは、メニューで0を選びます。

終了時の表示例

操作を選んでください:0

データベース接続を終了しました。
在庫管理アプリを終了します。

終了は、操作の途中でプログラムを打ち切る処理にはしません。一つの業務操作で必要な確定・取消と後片付けを済ませ、メニューへ戻ったところで終了を選べるようにします。

第10章では、この操作イメージをもとに、必要な機能、データ、関数、ファイルの対応を順番に決めていきます。次の記事では、商品CRUD、入庫、出庫、履歴表示に必要な機能を一覧に整理していきましょう。

Follow me!