サイトアイコン プログラマー(PG)・システムエンジニア(SE)になるための入門講座

「宣言」と「定義」の違いとは？IT初心者向けにプログラミングの基本をわかりやすく解説

pgse

「宣言」と「定義」の違いとは？IT初心者向けにプログラミングの基本をわかりやすく解説

結論から言うと、「宣言」は名前や種類の存在をプログラムへ知らせること、「定義」はその内容や実体を具体的に作ることです。

ただし、宣言と定義の扱いはプログラミング言語によって異なります。特にC言語やC++では区別が重要ですが、JavaやPythonでは同じ考え方がそのまま当てはまらない場合もあります。

初心者は、まず「宣言は予告」「定義は中身を用意すること」と覚えると理解しやすくなります。

宣言とは？

宣言とは、変数や関数、クラスなどについて、名前やデータ型、使い方をコンパイラへ知らせることです。

コンパイラとは、プログラムのソースコードをコンピューターが実行できる形式へ変換するソフトウェアです。

例えばC言語で関数を呼び出す前に、関数名や引数、戻り値を伝える処理は関数宣言と呼ばれます。

int calculateTotal(int price, int quantity);

この記述は、「calculateTotalという関数があり、整数を2つ受け取り、整数を返す」と知らせています。処理の中身はまだ書かれていません。

定義とは？

定義とは、宣言した変数や関数、クラスについて、実際の中身や実体を用意することです。

関数の場合は、実行する処理を具体的に記述します。

int calculateTotal(int price, int quantity) { return price * quantity; }

この記述では、商品の価格と数量を掛けて結果を返す処理まで書かれています。そのため、関数の定義です。

宣言と定義の違い

項目 宣言 定義
主な役割 名前や型、存在を知らせる 実体や処理内容を用意する
イメージ 予告、名簿への登録 本体の作成
関数の場合 関数名、引数、戻り値を示す 関数が実行する処理を書く
変数の場合 変数の存在を知らせる 保存領域を確保する
複数記述 言語によって複数回可能 通常は同じ対象を重複定義できない

身近な例で理解する

社員名簿で例える場合

新入社員が入社する予定だと社内へ知らせることが「宣言」に近い考え方です。

実際に社員番号やメールアドレス、所属部署を登録し、業務を開始できる状態にすることが「定義」に当たります。

建物で例える場合

「ここに会議室を作ります」と案内することが宣言です。

実際に部屋、机、椅子、設備を用意することが定義になります。

変数における宣言と定義

C言語やC++では、変数の宣言と定義を区別して考える場面があります。

extern int userCount;

これは、「userCountという整数型の変数が別の場所に存在する」と知らせる宣言です。通常、この記述だけでは変数本体の保存領域を作りません。

int userCount = 0;

こちらはuserCountという変数の実体を用意しているため、定義です。同時に変数名と型も知らせているので、宣言でもあります。

定義は宣言を兼ねることがありますが、宣言が必ず定義になるとは限りません。

関数における宣言と定義

関数宣言

void writeLog(char* message);

関数名、引数、戻り値だけを示しています。関数が何を実行するかは、この時点では書かれていません。

関数定義

void writeLog(char* message) { printf("%s", message); }

ログとして文字列を表示する処理が記述されています。この部分が関数の本体です。

初期化との違い

宣言や定義と一緒に覚えておきたい言葉が「初期化」です。

初期化とは、変数を作成するときに最初の値を設定することを指します。

用語 意味 例
宣言 名前や型の存在を知らせる extern int retryCount;
定義 変数の実体を用意する int retryCount;
初期化 最初の値を設定する int retryCount = 0;
代入 作成済みの変数へ値を入れる retryCount = 3;

int retryCount = 0;は、変数の定義と初期化を同時に行っています。

なぜ宣言と定義を分けるのか

大規模なプログラムでは、処理を複数のファイルへ分割します。

あるファイルで定義した関数を別のファイルから利用するとき、利用側へ関数の名前や形式を知らせる必要があります。そのために宣言を使います。

C言語やC++では、ヘッダーファイルへ宣言を書き、ソースファイルへ定義を書く構成が一般的です。

ファイル 主な内容
ヘッダーファイル 関数、型、クラスなどの宣言
ソースファイル 関数や変数の具体的な定義

どんな場面で使われるか

宣言と定義は、主に次のような場面で使われます。

プログラミング言語による違い

宣言と定義の用語は、すべての言語で同じように使われるわけではありません。

言語 特徴
C・C++ 宣言と定義の区別が重要
Java 変数宣言、クラス定義、メソッド定義などの表現が使われる
C# 宣言と初期化を区別することが多い
Python 変数は値を代入することで作られるため、C言語のような変数宣言は通常行わない
JavaScript letやconstで変数を宣言する

用語の意味を判断するときは、対象のプログラミング言語と文脈を確認することが大切です。

初心者が混乱しやすいポイント

宣言すると実体も作られる場合がある

int count;のような記述は、変数の存在を知らせると同時に保存領域も用意します。そのため、宣言であり定義でもあります。

「宣言と定義は必ず別々の記述になる」と覚えると混乱しやすいので注意しましょう。

初期化と定義を同じ意味だと思う

定義は実体を作ること、初期化は最初の値を設定することです。

変数を定義しても、必ず初期値を明示するとは限りません。ただし、未初期化の値は不具合につながるため、業務では可能な限り初期化することが重要です。

定義と設定を混同する

業務会話では「設定値を定義する」という表現も使われます。この場合の定義は、プログラミング言語上の厳密な定義ではなく、「ルールや値を決める」という一般的な意味です。

実際のIT現場での利用例

開発現場では、ヘッダーファイルへ関数宣言を追加したものの、ソースファイルへ関数定義を追加し忘れることがあります。

この状態では、コンパイル中に関数の呼び出し方は理解できても、最終的に実行する本体が見つかりません。その結果、リンクエラーが発生します。

反対に、同じ変数や関数を複数のファイルで重複定義すると、「すでに定義されている」というエラーになる場合があります。

筆者が経験した失敗談

新人時代、ヘッダーファイルへ関数宣言を追加しただけで、処理が完成したと思い込んだことがあります。

ビルドすると未解決の外部シンボルに関するリンクエラーが発生しました。ソースファイルを確認したところ、関数本体の定義を書いていなかったことが原因でした。

この経験から、エラーが出たときは「宣言がないのか」「定義がないのか」を分けて確認するようになりました。

業務でよくあるトラブル

トラブル 主な原因 確認ポイント
識別子が見つからない 宣言が不足している ヘッダーファイルや名前空間を確認する
未解決の外部シンボル 定義がない、ビルド対象に含まれていない 関数本体とプロジェクト設定を確認する
多重定義エラー 同じ対象を複数箇所で定義している 変数や関数の定義場所を検索する
宣言と定義の型が一致しない 引数や戻り値が異なる 宣言と関数本体を比較する
値が不定になる 変数を初期化していない 定義時の初期値を確認する

原因を切り分ける順番

  1. 表示されたエラーメッセージを省略せず確認する
  2. 対象の変数、関数、クラスの宣言が存在するか調べる
  3. 実際の定義が存在するか検索する
  4. 宣言と定義の名前、型、引数、戻り値を比較する
  5. 対象ファイルがビルドに含まれているか確認する
  6. 同じ名前の定義が複数存在しないか調べる
  7. クリーンビルドを実行して結果を確認する

確認結果の見方

ログの確認方法

宣言や定義に関する問題は、Windowsのイベントビューアーよりも、開発ツールのビルドログに詳しく表示されることが一般的です。

次の情報を確認します。

後続のエラーは、最初のエラーが原因で連続して発生している場合があります。まず先頭のエラーから確認するのが現場で評価される進め方です。

イベントビューアーを確認する場合

宣言や定義の不足は通常、ビルド時に発見されます。ただし、完成したアプリケーションが起動しない場合は、Windowsのイベントビューアーも確認します。

  1. Windowsキー＋Rを押す
  2. eventvwr.mscと入力してEnterキーを押す
  3. 「Windowsログ」を開く
  4. 「アプリケーション」を選択する
  5. 障害発生時刻付近の「エラー」を確認する

障害が発生したアプリケーション名、障害モジュール名、例外コードを記録します。

GUIでの確認方法

Visual Studioなどの統合開発環境では、次の機能を利用できます。

CUIでの確認方法

CUI（Character User Interface）とは、文字でコマンドを入力して操作する方法です。

Windowsでは、コマンドプロンプトやPowerShellでソースコード内の名前を検索できます。

コマンドプロンプトでは、findstr /s /n "calculateTotal" *.c *.hのように実行すると、対象の文字列を含むファイルと行番号を確認できます。

PowerShellでは、Get-ChildItem -Recurse -Include *.c,*.h | Select-String "calculateTotal"のように検索できます。

検索結果が1件もなければ定義漏れ、複数のソースファイルに本体があれば重複定義の可能性があります。

便利なショートカットキー

ショートカットキー 用途
Ctrl＋Shift＋F プロジェクト全体から文字列を検索する
F12 多くの開発ツールで定義へ移動する
Shift＋F12 参照箇所を表示する
Ctrl＋F 現在のファイル内を検索する
Windows＋R 「ファイル名を指定して実行」を開く

ショートカットキーは開発ツールや設定によって異なるため、利用中の環境でも確認してください。

ユーザー側・サーバー側の切り分け

宣言や定義の問題は、基本的にはプログラムのソースコードやビルド環境側の問題です。

切り分け対象 可能性
ユーザー操作 通常は低い
Windows端末 必要なモジュールや配布ファイル不足の可能性がある
アプリケーション 宣言、定義、ビルド設定の問題が考えられる
サーバー 異なるバージョンのモジュールが配置されている可能性がある
ネットワーク 通常は直接の原因にならない
Active Directory・DNS・DHCP 通常は宣言や定義のエラーとは関係しない

初心者がやりがちなミス

注意点

リンクエラーが発生したとき、インターネット上のコードをそのまま追加すると、重複定義や別の不具合を招くことがあります。

本番環境の実行ファイルやライブラリを直接置き換える操作も危険です。変更前にバックアップを取得し、開発環境や検証環境で動作を確認してください。

共通ヘッダーファイルや共通ライブラリの修正は影響範囲が広いため、担当者のレビューを受けてから反映します。

上司や担当者へ報告するポイント

「ビルドに失敗しました」だけではなく、「関数宣言は存在しますが、定義が見つからずリンクエラーになっています」のように報告すると、状況が伝わりやすくなります。

エスカレーションするタイミング

新人が覚えておくべきポイント

応用知識

プロトタイプ宣言

C言語では、関数名、引数、戻り値を事前に知らせる記述を関数プロトタイプ宣言と呼びます。

前方宣言

C++では、クラスの詳しい中身を書く前に、そのクラスが存在することだけを知らせる前方宣言があります。ヘッダーファイル同士の依存関係を減らすために使われます。

リンカー

リンカーとは、コンパイルされた複数のファイルやライブラリを結合し、実行ファイルを作る仕組みです。宣言は見つかっても定義が見つからない場合、リンク処理でエラーになります。

関連するIT用語

よくある質問（FAQ）

宣言と定義は同じ記述になることがありますか？

はい。例えば変数を作成する記述は、名前や型を知らせる宣言であると同時に、実体を用意する定義でもあります。

宣言だけではプログラムは動きませんか？

対象によります。関数は宣言だけでは処理本体がないため、最終的に定義が必要です。外部ライブラリ内に定義が存在する場合は、そのライブラリを正しくリンクする必要があります。

「未定義」と「未宣言」は同じエラーですか？

同じではありません。未宣言は名前や型をコンパイラが認識できない状態、未定義は実際の処理本体や実体が見つからない状態を指します。

コンパイルエラーとリンクエラーの違いは何ですか？

コンパイルエラーは、文法や型、宣言などを確認する段階で発生します。リンクエラーは、複数のファイルを結合するときに定義が見つからない場合や、重複している場合に発生します。

Pythonにも宣言と定義がありますか？

関数定義やクラス定義という言葉は使いますが、C言語のような変数の事前宣言は通常行いません。代入した時点で変数が作られます。

まとめ

「宣言」と「定義」の違いは、存在や形式を知らせるだけか、実際の中身や実体まで用意するかにあります。

宣言は「この名前の変数や関数があります」とプログラムへ知らせる役割を持ちます。定義は、変数の保存領域や関数の処理本体を実際に作ることです。

トラブル対応では、宣言不足ならコンパイルエラー、定義不足や重複定義ならリンクエラーを疑います。エラーメッセージ、対象ファイル、宣言と定義の一致、ビルド設定の順に確認すると、効率よく原因を切り分けられます。

「宣言は予告、定義は本体」と覚えておけば、ソースコードやビルドエラーの内容を理解しやすくなります。

モバイルバージョンを終了