Cの構文を知る段階から、一人前のCプログラマーになるまで

Cは非常に学びやすいプログラミング言語です。変数、関数、制御フロー文、構造体、ポインター、それだけです。そして何より重要なのは、Cがあなたに制御権を与えてくれることです。Cでコードを書くとき、あなたは神になるのです。

しかし、大いなる力には大いなる責任が伴います。すべてを完璧かつ効率的に動作させることもできますが、スタックオーバーフロー、ダングリングポインター、解放後使用、ヌルポインターのデリファレンス、二重解放、メモリーリーク、範囲外メモリーアクセスなどをプログラムに持ち込んで、すべてを台無しにしてしまうこともあります。

さらに、Cは制御権を与えてくれる強力な言語です。しかし、それはC++やPythonなどの言語と比べて、Cが提供する抽象化のレベルがはるかに低いことも意味します。そのため、目的を達成するために必要なロジックの多くを、自分で実装しなければなりません。したがって、Cの構文を知っていることと、一人前のCプログラマーになることの間には、大きな隔たりがあります。

私は2024/2025年にCを学びましたが、実際に本番環境で使えるプログラムを書いて知識を実践することなく、C++の学習に移ってしまいました。その後、C++とQtを使ってアプリケーションを書き始め、これを快適に感じていました。しかし最近、libcanokeyを使ってCanoKeyのコンパニオンアプリケーションを実装しようとした際、いくつもの壁にぶつかっています。このプロジェクトは当初、C++ + Qt + Kirigamiによるプログラミングを練習するためのものでした。しかし、「Cを知っている」状態から「Cで実用的なプログラムを開発する方法を知っている」状態になるまでには、まだ多くのことを学ぶ必要があると気づきました。

この記事では、いくつかの簡単な例を紹介します。Cの構文を学んだばかりで、Cを使って実用的なプログラムを書く方法がまだ分からない人たちの助けになれば幸いです。

Cにおけるオブジェクト指向プログラミング

Cは標準でオブジェクト指向プログラミングをサポートしていません。複数の値をまとめるための主要な組み込み集約型の一つは、構造体と呼ばれます。構造体は、Cの組み込み型やほかの構造体型の複数のメンバーを一つの型にまとめます。メンバー間にはパディングが挿入される場合もあります。しかし、フリーソフトウェアコミュニティの多くのCプロジェクトやライブラリーでは、手作業で実装した疑似オブジェクト指向設計が採用されています。Cの構文を拡張するのではなく、構造体を利用して目的を達成しているのです。

基本的な考え方

構造体を定義します。

typedef struct Counter
{
    int a;
} Counter;

そして、いくつかの関数を定義します。

Counter *counter_create()
{
    Counter *ans = malloc(sizeof *ans);
    if (! ans) return NULL;
    ans->a = 0;
    return ans;
}

void counter_increase(Counter *self)
{
    self->a++;
}

int counter_get_value(Counter *self)
{
    return self->a;
}

おめでとうございます!これでCにおけるクラスとそのメソッドを実装できました。

同じことを行うC++のクラスは、次のようになります。

class Counter
{
public:
    Counter()
    : a(0) {}

    void increase()
    {
        this->a++;
    }

    int get_value() const
    {
        return this->a;
    }

private:
    int a;
}

基本的な考え方は、構造体をオブジェクトとして、関数をメソッドとして使うことです。

カプセル化

通常、私たちは自分で定義した構造体をオブジェクトとして扱い、一連の関数を使って操作します。しかし、構造体のメンバーを直接変更することも依然として可能であり、予期しない動作を引き起こす可能性があります。

Cには、指定した一連の関数を通じた変更は許可しながら、構造体の直接変更を禁止する仕組みがありません。しかし、この目的を達成するための方法があります。

構造体と関数の宣言をヘッダーファイル counter.h に記述します。

#ifndef COUNTER_H
#define COUNTER_H

typedef struct Counter Counter;
Counter *counter_create();
void counter_increase(Counter *self);
int counter_get_value(Counter *self);

#endif

そして、実装を counter.c に記述します。

#include "counter.h"

struct Counter
{
    int a;
};

Counter *counter_create()
{
    Counter *ans = malloc(sizeof *ans);
    if (! ans) return NULL;
    ans->a = 0;
    return ans;
}

void counter_increase(Counter *self)
{
    self->a++;
}

int counter_get_value(Counter *self)
{
    return self->a;
}

Counterを使用する必要があるソースファイルでは、次のように記述するだけです。

#include "counter.h"

これで、ソースファイルはCounterという構造体が存在し、それを操作できる関数がいくつか存在することを認識できます。しかし、その構造体が具体的にどのメンバーを持っているのか、また各関数が何をするのかは分かりません。そのため、ポインターを既知の型に強制的に型変換しない限り、構造体を直接変更することはできません。

継承

別の構造体を定義します。

typedef struct CounterPlusPlus
{
    Counter pref;
    int step;
} CounterPlusPlus;

そして、メソッドを定義します。

void counter_plus_plus_increase(CounterPlusPlus *self)
{
    self->pref.a += self->step;
}

もちろん、強化されたカウンターの値を取得するために、int counter_plus_plus_get_value(CounterPlusPlus *self)のような関数を定義することもできます。しかし、その必要はありません!

構造体のメンバーは宣言された順序に従って配置されますが、メンバー間にはパディングが挿入される場合があります。CounterPlusPlusは、Counterの後にintが続く構造体です。したがって、CounterPlusPlusインスタンスのアドレスは、最初のメンバーであるprefのアドレスと同じです!

そのため、CounterPlusPlus *をCounter *に型変換し、int counter_get_value(Counter *self)に渡して、その関数にCounterとして扱わせることができます。期待どおりに動作します!

これは、Cで継承を実装する際によく使われる方法です。GObjectはこの方法を非常に広範囲に採用しており、そのデータ型の多くはこの方法でGObjectを継承しています。

リソース管理と所有権

Cでは、メモリーを確保したり解放したりする自由が与えられています。しかし、その自由を適切に使わなければ、メモリーリーク、二重解放、解放後使用などの問題に遭遇する可能性が非常に高くなります。

所有権は、Cプログラマーが確保済みメモリーを正しく管理するために従う慣習です。詳しくは、以前の記事を参照してください。

ハードウェアとの直接通信

システムプログラミングではCが広く使われており、Cがハードウェアと直接通信できることをご存じかもしれません。Cを学び始めたばかりの人や中級レベルの学習者の多くは、これがハードウェアインターフェースによって導入された特別なC構文に基づいていると考えるかもしれません。しかし、ほとんどの場合、そうではありません。

ほとんどのメーカーは、ファームウェアやドライバーの開発を容易にするために、自社のハードウェア向けのハードウェア抽象化層を提供しています。この層は、ハードウェアを操作するための関数を提供します。しかし、ほとんどの場合、ハードウェア抽象化層自体もCで書かれています。では、ハードウェア抽象化層はどのようなCの構文を使ってハードウェアを操作するのでしょうか。

実際、一部のハードウェアプラットフォームは、特定の操作のために専用の機械語命令を提供しています。これらの命令は、アセンブリー言語とCを組み合わせることで利用できます。しかし、ほとんどの場合、Cからハードウェアと通信する方法は、次のようなコードを書くことと大差ありません。

*((volatile uint32_t *)0x40000000UL) = 1;

そうです。見間違いではありませんし、冗談でもありません。アドレス、型変換、そして通常の整数代入。それだけです。

ほとんどのハードウェアには、動作を制御するための制御レジスターがあります。そこに値を書き込むことで、さまざまな処理を実行させることができます。MMIOなどの技術では、これらのレジスターを一つまたは複数のアドレス空間にマッピングするため、通常のメモリーとほぼ同じ方法でアクセスできます。周辺機器のレジスターを読み書きすることで、ハードウェアを設定し、その動作状態を制御し、サポートされている操作を実行させることができます。周辺機器の内部ロジックは、これらのレジスターアクセスを解釈して、対応する処理を実行します。ほかにも、対応するアーキテクチャで独立したI/Oアドレス空間を使用するPMIOなどの技術があります。

何も不思議なことでも、不透明なことでもありません。

さらなる学習の提案

上に挙げた項目は、氷山の一角にすぎません。

現在、私は大規模言語モデルサービスの提供事業者が提供する学習モードを使って、これらの内容を詳しく学んでいます。学習ロードマップが生成されたので、ここに重要な項目をいくつか挙げます。皆さんの役に立てば幸いです。

  1. メモリー管理と所有権
    • スタック割り当てとヒープ割り当て。
    • オブジェクトの寿命と記憶域期間。
    • 所有権、借用、所有権の移転。
    • 浅いコピーと深いコピー。
    • 参照カウント。
    • リソースの取得と解放。
    • 部分的な初期化と失敗時の後始末。
    • メモリーリーク、二重解放、解放後使用の防止。
    • 柔軟配列メンバー。
    • アラインメントとパディング。
    • メモリー割り当てサイズのオーバーフロー。
  2. API設計とカプセル化
    • 不透明な構造体。
    • 公開ヘッダーと非公開ヘッダー。
    • コンストラクターとデストラクター。
    • 初期化関数と終了処理関数。
    • ゲッターとセッター。
    • 参照カウントAPI。
    • コピーとクローン。
    • 関数の契約。
    • 事前条件と事後条件。
    • エラー報告。
    • APIドキュメント。
    • 名前空間の規則。
    • コールバックAPI。
  3. コンパイルプロセス全体
    • プリプロセス。
    • コンパイル。
    • アセンブル。
    • リンク。
    • 翻訳単位。
    • オブジェクトファイル。
    • シンボルテーブル。
    • 未定義シンボル。
    • シンボルの可視性。
    • 静的ライブラリー。
    • 共有ライブラリー。
    • 位置独立コード。
    • 実行時のライブラリー読み込み。
    • 動的リンク。
    • ABI互換性。
  4. 高度なポインター技法
    • ポインター演算。
    • 配列とポインター:類似点と相違点。
    • ポインターへのポインター(T **)。
    • 配列へのポインター。
    • 関数ポインター。
    • 構造体へのポインター。
    • constの適切な使用。
    • restrict。
    • void *とジェネリックプログラミング。
    • ヌルポインターと無効なポインター。
    • ポインターの寿命とエイリアシング規則。
  5. 構造体とデータ指向設計
    • 構造体の合成。
    • 不透明な構造体。
    • 公開構造体と非公開構造体。
    • タグ付き共用体。
    • 列挙型。
    • ビットフィールドとその移植性に関する制限。
    • 構造体のパディングとアラインメント。
    • 柔軟配列メンバー。
    • 侵入型と非侵入型のデータ構造。
    • 構造体の初期化。
    • 複合リテラル。
  6. Cの文字列とバイナリーデータ
    • ヌル終端文字列。
    • 文字配列。
    • バッファーのサイズと容量。
    • strlen()、strcmp()、memcpy()、memmove()。
    • 安全な文字列の構築。
    • 動的文字列バッファー。
    • UTF-8。
    • 文字エンコーディングとバイト表現の違い。
    • 整数の書式化とprintf()の書式指定子。
    • 書式文字列の脆弱性。
    • バイナリーデータの処理。
  7. 整数型と未定義動作
    • 整数の昇格。
    • 符号付き演算と符号なし演算。
    • 整数オーバーフロー。
    • 整数変換。
    • 固定幅整数型(uint32_t、int64_tなど)。
    • size_t、ptrdiff_t、uintptr_t。
    • エンディアン。
    • アラインメント。
    • 未定義動作。
    • 未規定動作。
    • 実装定義の動作。
    • 厳密なエイリアシング規則。
  8. エラー処理
    • 戻り値に基づくエラー処理。
    • エラーコード。
    • エラー出力パラメーター。
    • gotoを使った後始末のパターン。
  9. Cにおけるデータ構造とアルゴリズム
    • 動的配列。
    • 連結リスト。
    • 双方向連結リスト。
    • ハッシュテーブル。
    • 木構造。
    • 二分探索木。
    • 平衡木。
    • キュー。
    • スタック。
    • ヒープ。
    • リングバッファー。
    • 文字列ビルダー。
    • イテレーター。
  10. 関数ポインター、コールバック、ポリモーフィズム
    • コールバックの登録。
    • 関数ポインター。
    • 構造体内の関数ポインター。
    • 仮想関数テーブルのパターン。
    • インターフェースの実装。
    • イベントハンドラー。
    • ユーザーデータへのポインター。
    • プラグインインターフェース。
    • 動的ディスパッチ。
  11. オペレーティングシステムとのインターフェース
    • C標準ライブラリーとオペレーティングシステムのAPI。
    • POSIX。
    • ファイルディスクリプター。
    • ファイルストリーム(FILE *)。
    • ファイル操作。
    • ディレクトリーとパス。
    • プロセス。
    • 環境変数。
    • パイプ。
    • シグナル。
    • ソケット。
    • メモリーマッピング(mmap())。
    • システムコール。
  12. 並行処理とマルチスレッド
    • プロセスとスレッド。
    • POSIXスレッド。
    • ミューテックス。
    • 条件変数。
    • セマフォ。
    • アトミック操作。
    • データ競合。
    • デッドロック。
    • スレッドセーフ。
    • スレッドローカルストレージ。
    • メモリー順序。
    • イベントループ。
    • 非同期プログラミング。
  13. イベント駆動型プログラミング
    • イベントループ。
    • イベントキュー。
    • イベントのディスパッチ。
    • コールバック。
    • タイマー。
    • 入力イベント。
    • ウィンドウイベント。
    • 非同期操作。
    • アプリケーションのライフサイクル。
  14. ビルドシステム
    • GNU Make
    • AutoconfとAutomake
    • Meson
    • CMake
  15. ライブラリーのインストールと依存関係の管理
    • インクルードディレクトリー。
    • ライブラリーディレクトリー。
    • pkg-config。
    • .pcファイル。
    • PKG_CONFIG_PATH。
    • 静的リンクと共有リンク。
    • 実行時ライブラリーパス。
    • インストールプレフィックス。
    • ヘッダーファイルのインストール。
    • ライブラリーのバージョン管理。
    • 依存関係の検出。
    • 推移的依存関係。
  16. デバッグ
    • GDB。
    • ブレークポイント。
    • バックトレース。
    • スタックフレーム。
    • 変数の調査。
    • コアダンプ。
    • ウォッチポイント。
    • デバッグシンボル。
    • 最適化されたプログラムのデバッグ。
    • セグメンテーションフォールトのデバッグ。
  17. メモリーエラーと未定義動作の検出
    • AddressSanitizer:範囲外アクセス、解放後使用、その他のメモリーエラーの検出。
    • UndefinedBehaviorSanitizer:さまざまな形式の未定義動作の検出。
    • Valgrind Memcheck:無効なメモリーアクセス、未初期化値、メモリーリークの検出。
    • MemorySanitizer:未初期化メモリーの使用の検出。
    • 静的解析:プログラムを実行せずに潜在的な欠陥を検出。
  18. ソフトウェアテスト
    • 単体テスト。
    • 統合テスト。
    • 回帰テスト。
    • テストフィクスチャ。
    • テストアサーション。
    • 境界値テスト。
    • エラー経路テスト。
    • メモリーリークテスト。
    • ファジングテスト。
    • 継続的インテグレーション。
  19. パフォーマンス分析
    • アルゴリズム計算量。
    • キャッシュ局所性。
    • メモリー割り当てのオーバーヘッド。
    • プロファイリング。
    • CPUプロファイリング。
    • メモリープロファイリング。
    • ベンチマーク。
    • データ指向の最適化。
  20. コーディング規約と可読性
    • 命名規則。
    • インデント。
    • 関数の整理。
    • ヘッダーの整理。
    • コメント。
    • ドキュメントコメント。
    • 公開シンボルと非公開シンボルの命名。
    • ファイルの整理。
    • 不必要なマクロの回避。
    • 不必要なグローバル変数の回避。
    • 関数を理解しやすく保つこと。
    • 一貫性の維持。
  21. ドキュメント
    • 公開関数。
    • 関数パラメーター。
    • 戻り値。
    • エラー条件。
    • 所有権の移転。
    • オブジェクトのライフサイクル。
    • スレッドセーフ性の保証。
    • APIの安定性。
    • 使用例。
  22. APIとABIの安定性
    • APIとは何か。
    • ABIとは何か。
    • 何が互換性のない変更に該当するのか。
    • 構造体のメンバーを公開すると問題が生じる可能性がある理由。
    • シンボルの可視性。
    • 共有ライブラリーのバージョン管理。
    • 非推奨化。
    • 後方互換性。
    • 異なるバージョンのライブラリーの並行インストール。
  23. 国際化と地域化
    • UTF-8。
    • 文字エンコーディング。
    • ロケール。
    • gettext。
    • 翻訳カタログ。
    • 複数形。
    • 日付と数値の書式化。
    • エラーメッセージの翻訳。
    • ユーザー向け文字列のハードコーディングを避けること。
  24. Gitと共同開発
    • リポジトリー。
    • コミット。
    • ブランチ。
    • マージ。
    • リベース。
    • 差分の確認。
    • コンフリクトの解決。
    • パッチの作成。
    • コードレビュー。
    • 問題の報告。
    • リリースブランチ。

または、簡略版:

  1. ステージ1 — CらしいCプログラミング
    • メモリーの所有権と寿命。
    • 高度なポインターと構造体。
    • 文字列とバッファーの処理。
    • エラー処理。
    • データ構造。
    • 関数ポインターとコールバック。
  2. ステージ2 — ライブラリー開発
    • 不透明型とAPI設計。
    • ヘッダーファイルとソースファイルの整理。
    • 静的ライブラリーと共有ライブラリー。
    • コンパイルとリンク。
    • pkg-config。
    • ABIとAPIの安定性。
  3. ステージ3 — プロフェッショナルなC開発
    • POSIXとシステムプログラミング。
    • ビルドシステム。
    • デバッグとプロファイリング。
    • 単体テストと統合テスト。
    • サニタイザーと静的解析。
    • ドキュメントとコーディング規約。
  4. ステージ4 — エコシステム開発
    • GLibとGObject。
    • GNUの開発慣行。
    • SDLの開発慣行。
    • Gitと共同開発。
    • API互換性。
    • 成熟したプロジェクトへのパッチの貢献。
Hugo で構築されています。
テーマ Stack は Jimmy によって設計されています。