未定義シンボルエラーは、C++ プログラミングにおいてよくある問題であり、コンパイルとリンクの過程で初心者を混乱させることがよくあります。これらのエラーは、コード内で使用されている関数または変数の実装をコンパイラが見つけられない場合に発生します。この実験（Lab）では、実践的なハンズオンの例を通して、さまざまな種類の未定義シンボルエラーを特定し、理解し、解決する方法を学びます。
この実験（Lab）の終わりには、コンパイルとリンクのプロセス、未定義シンボルエラーの一般的な原因、そして C++ プロジェクトでこれらの問題を診断し修正するための効果的な戦略について、確かな理解が得られるでしょう。
このステップでは、未定義シンボルエラーとは何かを探求し、それらがどのように発生するかを示す簡単な例を作成します。
未定義シンボルエラーは、通常、コンパイルのリンク段階で発生します。これは、リンカーが、コード内で宣言され使用されている関数または変数の実装を見つけられない場合に起こります。C++ のコンパイルプロセスは、いくつかの段階で構成されています。
リンカーがシンボル参照を解決できない場合、「未定義シンボル（undefined symbol）」または「未定義参照（undefined reference）」エラーを生成します。
未定義シンボルエラーを示す簡単な例を作成しましょう。2 つのファイルを作成します。
まず、ヘッダーファイルを作成しましょう。エディタで calculator.h という名前の新しいファイルを作成します。
#ifndef CALCULATOR_H
#define CALCULATOR_H
// Function declarations
int add(int a, int b);
int subtract(int a, int b);
#endif次に、これらの関数を使用するメインファイルを作成しましょう。main.cpp という名前の新しいファイルを作成します。
#include <iostream>
#include "calculator.h"
int main() {
int result1 = add(5, 3);
int result2 = subtract(10, 4);
std::cout << "Addition result: " << result1 << std::endl;
std::cout << "Subtraction result: " << result2 << std::endl;
return 0;
}次に、プログラムをコンパイルし、エラーを観察しましょう。ターミナルを開き、以下を実行します。
g++ main.cpp -o calculator_app次のようなエラーメッセージが表示されるはずです。
/tmp/cc7XaY5A.o: In function `main':
main.cpp:(.text+0x13): undefined reference to `add(int, int)'
main.cpp:(.text+0x26): undefined reference to `subtract(int, int)'
collect2: error: ld returned 1 exit statusエラーメッセージは、リンカーが、ヘッダーファイルで宣言され、main.cpp で使用されている add および subtract 関数の実装を見つけられないことを示しています。
これは、以下の理由で発生します。
calculator.h で関数宣言のみを提供しました。次のステップでは、不足している関数の実装を提供することにより、このエラーを修正します。
このステップでは、前回のステップで発生した未定義シンボルエラーを、宣言された関数の実装を提供することで修正します。
未定義シンボルエラーを修正する最も一般的な方法は、不足している関数を実装することです。関数の実装を含む calculator.cpp という名前の新しいファイルを作成しましょう。
#include "calculator.h"
// Function implementations
int add(int a, int b) {
return a + b;
}
int subtract(int a, int b) {
return a - b;
}実装ファイルができたので、すべてのソースファイルを一緒にコンパイルする必要があります。これを行うには、主に 2 つの方法があります。
g++ main.cpp calculator.cpp -o calculator_appg++ -c main.cpp -o main.o
g++ -c calculator.cpp -o calculator.o
g++ main.o calculator.o -o calculator_app簡単にするために、最初の方法を使用しましょう。次のコマンドを実行します。
g++ main.cpp calculator.cpp -o calculator_app今回は、コンパイルはエラーなしで成功するはずです。これで、プログラムを実行できます。
./calculator_app次の出力が表示されるはずです。
Addition result: 8
Subtraction result: 6なぜ私たちの解決策がうまくいったのかを理解しましょう。
calculator.cpp）を作成しました。この宣言と実装の分離は、C++ プログラミングにおける一般的な慣行であり、以下のような利点があります。
未定義シンボルエラーにつながる別の一般的なシナリオを探求しましょう。math_utils.h という名前の新しいファイルを作成します。
#ifndef MATH_UTILS_H
#define MATH_UTILS_H
// Function declarations with a missing implementation
double square(double x);
double cube(double x);
// Variable declaration without definition
extern int MAX_VALUE;
#endif次に、test_math.cpp という名前のファイルを作成します。
#include <iostream>
#include "math_utils.h"
int main() {
double num = 5.0;
std::cout << "Square of " << num << ": " << square(num) << std::endl;
std::cout << "Maximum value: " << MAX_VALUE << std::endl;
return 0;
}このコードをコンパイルしてみましょう。
g++ test_math.cpp -o math_test関数と変数の両方について、再び未定義シンボルエラーが表示されます。
/tmp/ccjZpO2g.o: In function `main':
test_math.cpp:(.text+0x5b): undefined reference to `square(double)'
test_math.cpp:(.text+0x79): undefined reference to `MAX_VALUE'
collect2: error: ld returned 1 exit statusこれは、未定義シンボルエラーが、関数と変数の両方で、宣言されているが定義されていない場合に発生する可能性があることを示しています。
未定義シンボルエラーは、コードが外部ライブラリを使用しているが、それらに適切にリンクしていない場合に頻繁に発生します。このステップでは、これらの種類のエラーを解決する方法を探ります。
標準 C 数学ライブラリの数学関数を使用する簡単なプログラムを作成しましょう。math_example.cpp という名前の新しいファイルを作成します。
#include <iostream>
#include <cmath>
int main() {
double x = 2.0;
// Using functions from the math library
double square_root = sqrt(x);
double log_value = log(x);
double sine_value = sin(M_PI / 4);
std::cout << "Square root of " << x << ": " << square_root << std::endl;
std::cout << "Natural log of " << x << ": " << log_value << std::endl;
std::cout << "Sine of PI/4: " << sine_value << std::endl;
return 0;
}まず、数学ライブラリに明示的にリンクせずに、このプログラムをコンパイルしてみましょう。
g++ math_example.cpp -o math_example一部のシステムでは、標準ライブラリが自動的にリンクされる可能性があるため、これが機能する場合があります。ただし、多くの Linux システムでは、次のようなエラーが表示されます。
/tmp/ccBwPe5g.o: In function `main':
math_example.cpp:(.text+0x57): undefined reference to `sqrt'
math_example.cpp:(.text+0x73): undefined reference to `log'
math_example.cpp:(.text+0x9b): undefined reference to `sin'
collect2: error: ld returned 1 exit statusこれを修正するには、-lm フラグを使用して数学ライブラリに明示的にリンクする必要があります。
g++ math_example.cpp -o math_example -lmこれで、コンパイルは成功するはずです。プログラムを実行しましょう。
./math_example次のような出力が表示されるはずです。
Square root of 2: 1.41421
Natural log of 2: 0.693147
Sine of PI/4: 0.707107-l フラグは、コンパイラに特定のライブラリにリンクするように指示します。
-lm は数学ライブラリ（libm）にリンクします。-lpthread は POSIX スレッドライブラリにリンクします。-lcurl は cURL ライブラリにリンクします。システムライブラリの場合、コンパイラはそれらを見つける場所を知っています。カスタムまたはサードパーティのライブラリの場合、-L フラグを使用してライブラリパスを指定する必要がある場合もあります。
プロセスを示すために、簡単なカスタムライブラリを作成しましょう。まず、geometry.h という名前のヘッダーファイルを作成します。
#ifndef GEOMETRY_H
#define GEOMETRY_H
// Function declarations for our geometry library
double calculateCircleArea(double radius);
double calculateRectangleArea(double length, double width);
#endif次に、geometry.cpp という名前の実装ファイルを作成します。
#include "geometry.h"
#include <cmath>
// Implementation of geometry functions
double calculateCircleArea(double radius) {
return M_PI * radius * radius;
}
double calculateRectangleArea(double length, double width) {
return length * width;
}幾何学ライブラリを使用するメインプログラムを作成しましょう。geometry_app.cpp という名前のファイルを作成します。
#include <iostream>
#include "geometry.h"
int main() {
double radius = 5.0;
double length = 4.0;
double width = 6.0;
std::cout << "Circle area (radius=" << radius << "): "
<< calculateCircleArea(radius) << std::endl;
std::cout << "Rectangle area (" << length << "x" << width << "): "
<< calculateRectangleArea(length, width) << std::endl;
return 0;
}ライブラリを使用するには、2 つのオプションがあります。
g++ geometry_app.cpp geometry.cpp -o geometry_app -lm## Compile the library file to an object file
g++ -c geometry.cpp -o geometry.o
## Create a static library (archive)
ar rcs libgeometry.a geometry.o
## Compile the main program and link to our library
g++ geometry_app.cpp -o geometry_app -L. -lgeometry -lm簡単にするために、オプション 1 を使用しましょう。
g++ geometry_app.cpp geometry.cpp -o geometry_app -lmプログラムを実行します。
./geometry_app次のような出力が表示されるはずです。
Circle area (radius=5): 78.5398
Rectangle area (4x6): 24-l<library> を使用してライブラリにリンクします。-L<path> を使用してライブラリパスを指定する必要がある場合があります。.a 拡張子があります（Linux/macOS）。.so 拡張子があり（Windows では .dll、macOS では .dylib）。未定義シンボルエラーのもう 1 つの一般的な原因は、名前空間とスコープの問題です。このステップでは、これらがどのように未定義シンボルエラーにつながるか、そしてそれらを解決する方法を探ります。
名前空間に関連する未定義シンボルエラーを示す例を作成しましょう。utils.h という名前のファイルを作成します。
#ifndef UTILS_H
#define UTILS_H
namespace Math {
// Function declarations in Math namespace
double multiply(double a, double b);
double divide(double a, double b);
}
namespace Text {
// Function declarations in Text namespace
std::string concatenate(const std::string& a, const std::string& b);
int countWords(const std::string& text);
}
#endif次に、実装ファイル utils.cpp を作成します。
#include <string>
#include <sstream>
#include "utils.h"
namespace Math {
// Implementations in Math namespace
double multiply(double a, double b) {
return a * b;
}
double divide(double a, double b) {
return a / b;
}
}
namespace Text {
// Implementations in Text namespace
std::string concatenate(const std::string& a, const std::string& b) {
return a + b;
}
int countWords(const std::string& text) {
std::istringstream stream(text);
std::string word;
int count = 0;
while (stream >> word) {
count++;
}
return count;
}
}これらの名前空間を誤って使用するメインファイルを作成しましょう。namespace_example.cpp という名前のファイルを作成します。
#include <iostream>
#include <string>
#include "utils.h"
int main() {
// Incorrect: Functions called without namespace qualification
double product = multiply(5.0, 3.0);
std::string combined = concatenate("Hello ", "World");
std::cout << "Product: " << product << std::endl;
std::cout << "Combined text: " << combined << std::endl;
return 0;
}プログラムをコンパイルしてみましょう。
g++ namespace_example.cpp utils.cpp -o namespace_example次のようなエラーが表示されるはずです。
namespace_example.cpp: In function 'int main()':
namespace_example.cpp:7:22: error: 'multiply' was not declared in this scope
double product = multiply(5.0, 3.0);
^~~~~~~~
namespace_example.cpp:8:25: error: 'concatenate' was not declared in this scope
std::string combined = concatenate("Hello ", "World");
^~~~~~~~~~~~これらのエラーは、関数が名前空間内で定義されているのに、名前空間を指定せずにそれらを呼び出そうとしているために発生します。
名前空間の問題を修正しましょう。namespace_fixed.cpp という名前の修正されたバージョンを作成します。
#include <iostream>
#include <string>
#include "utils.h"
int main() {
// Method 1: Fully qualified names
double product = Math::multiply(5.0, 3.0);
std::string combined = Text::concatenate("Hello ", "World");
std::cout << "Product: " << product << std::endl;
std::cout << "Combined text: " << combined << std::endl;
// Method 2: Using directive (less preferred)
using namespace Math;
double quotient = divide(10.0, 2.0);
std::cout << "Quotient: " << quotient << std::endl;
// Method 3: Using declaration (more targeted)
using Text::countWords;
int words = countWords("This is a sample sentence.");
std::cout << "Word count: " << words << std::endl;
return 0;
}修正されたプログラムをコンパイルします。
g++ namespace_fixed.cpp utils.cpp -o namespace_fixedこれはエラーなしでコンパイルされるはずです。プログラムを実行しましょう。
./namespace_fixed次のような出力が表示されるはずです。
Product: 15
Combined text: Hello World
Quotient: 5
Word count: 5名前空間の問題を解決するさまざまな方法を理解しましょう。
Math::multiply）。using namespace Math;）。using Text::countWords;）。各方法にはそれぞれの役割がありますが、潜在的な名前の競合を避けるために、完全修飾名またはターゲットを絞った using 宣言を使用することが一般的に推奨されます。
スコープの問題も、未定義シンボルエラーを引き起こす可能性があります。
static で宣言された変数は、その翻訳単位内でのみ表示されます。スコープ関連の問題の簡単な例を作成しましょう。scope_example.cpp という名前のファイルを作成します。
#include <iostream>
// This variable is only visible in this file
static int counter = 0;
void incrementCounter() {
counter++;
}
int getCounterValue() {
return counter;
}
// This function is in an anonymous namespace and only visible in this file
namespace {
void privateFunction() {
std::cout << "This function is private to this file" << std::endl;
}
}
int main() {
incrementCounter();
incrementCounter();
std::cout << "Counter value: " << getCounterValue() << std::endl;
privateFunction(); // This works because we're in the same file
return 0;
}この例は、エラーなしでコンパイルして実行できるはずです。
g++ scope_example.cpp -o scope_example
./scope_example期待される出力：
Counter value: 2
This function is private to this fileただし、別のファイルから counter または privateFunction にアクセスしようとすると、スコープが制限されているため、未定義シンボルエラーが発生します。
この最終ステップでは、未定義シンボルエラーを診断し、解決するためのより高度なテクニックを探ります。
コンパイラとリンカのフラグは、何が問題なのかに関するより多くの情報を提供できます。debug_example.cpp という名前のファイルを作成します。
#include <iostream>
// Forward declaration without implementation
void missingFunction();
int main() {
std::cout << "Calling missing function..." << std::endl;
missingFunction();
return 0;
}これを詳細な出力でコンパイルしてみましょう。
g++ debug_example.cpp -o debug_example -vこれにより、コンパイルとリンクプロセスに関する詳細な情報が得られます。missingFunction の未定義参照エラーが表示されます。
nm ツールは、オブジェクトファイルとライブラリ内のシンボルを表示します。これは、シンボルが実際に定義されているかどうかを確認するのに役立ちます。
実装ファイルを含む簡単なプログラムを作成しましょう。まず、functions.h を作成します。
#ifndef FUNCTIONS_H
#define FUNCTIONS_H
void sayHello();
void sayGoodbye();
#endif次に、functions.cpp を作成します。
#include <iostream>
#include "functions.h"
void sayHello() {
std::cout << "Hello, world!" << std::endl;
}
// Notice: sayGoodbye is not implemented次に、greetings.cpp を作成します。
#include "functions.h"
int main() {
sayHello();
sayGoodbye(); // This will cause an undefined symbol error
return 0;
}実装ファイルをオブジェクトファイルにコンパイルします。
g++ -c functions.cpp -o functions.o次に、nm を使用して、オブジェクトファイルで定義されているシンボルを確認しましょう。
nm functions.o次のような出力が表示されるはずです。
U __cxa_atexit
U __dso_handle
0000000000000000 T _Z8sayHellov
U _ZNSt8ios_base4InitC1Ev
U _ZNSt8ios_base4InitD1Ev
U _ZSt4cout
U _ZStlsISt11char_traitsIcEERSt13basic_ostreamIcT_ES5_PKc
0000000000000000 r _ZStL19piecewise_construct
0000000000000000 b _ZStL8__ioinitsayHello が定義されていること（テキスト/コードセクションの T で示されます）に注意してください。ただし、sayGoodbye のシンボルはありません。これは、関数に実装がないことを確認します。
ldd ツールは、実行可能ファイルのライブラリ依存関係を表示します。これは、ライブラリのリンクに問題がある場合に役立ちます。
pthread ライブラリを使用する簡単な例を作成しましょう。thread_example.cpp という名前のファイルを作成します。
#include <iostream>
#include <pthread.h>
void* threadFunction(void* arg) {
std::cout << "Thread running" << std::endl;
return nullptr;
}
int main() {
pthread_t thread;
int result = pthread_create(&thread, nullptr, threadFunction, nullptr);
if (result != 0) {
std::cerr << "Failed to create thread" << std::endl;
return 1;
}
pthread_join(thread, nullptr);
std::cout << "Thread completed" << std::endl;
return 0;
}pthread ライブラリでコンパイルします。
g++ thread_example.cpp -o thread_example -pthread次に、ldd を使用してライブラリの依存関係を確認します。
ldd thread_example実行可能ファイルが依存するすべての共有ライブラリ（pthread ライブラリを含む）がリストされた出力が表示されるはずです。
未定義シンボルエラーの一般的な原因とその解決策をまとめましょう。
| 原因 | 解決策 |
|---|---|
| 関数の実装がない | 関数を実装するか、実装を含むファイルにリンクする |
| ライブラリのリンクがない | 適切な -l フラグを追加する（例：数学の場合は -lm） |
| 名前空間の問題 | 修飾名（Namespace::function）または using ディレクティブ/宣言を使用する |
| スコープの制限 | シンボルが呼び出し元のスコープからアクセス可能であることを確認する |
| シンボル名のマングリング | C/C++ 相互運用性のために extern "C" を使用するか、適切なデマングリングを使用する |
| テンプレートのインスタンス化エラー | 明示的なテンプレートのインスタンス化を提供するか、実装をヘッダーに移動する |
未定義シンボルエラーをデバッグするための体系的なアプローチを次に示します。
正確な未定義シンボルを特定する
nm を使用して、シンボルがオブジェクトファイルに存在するかどうかを確認する実装の問題を確認する
ライブラリのリンクを確認する
-lm、-lpthread）ldd を使用してライブラリの依存関係を確認する名前空間とスコープを調べる
名前のマングリングの問題を探す
extern "C" を追加するテンプレート関連のエラーを処理する
未定義シンボルエラーを回避するためのベストプラクティスを示す包括的な例を作成しましょう。適切な組織化された小さなプロジェクトを作成します。
mkdir -p library/include library/src applibrary/include/calculations.h を作成します。#ifndef CALCULATIONS_H
#define CALCULATIONS_H
namespace Math {
double add(double a, double b);
double subtract(double a, double b);
double multiply(double a, double b);
double divide(double a, double b);
}
#endiflibrary/src/calculations.cpp に実装を作成します。#include "calculations.h"
namespace Math {
double add(double a, double b) {
return a + b;
}
double subtract(double a, double b) {
return a - b;
}
double multiply(double a, double b) {
return a * b;
}
double divide(double a, double b) {
return a / b;
}
}app/calculator.cpp にメインアプリケーションを作成します。#include <iostream>
#include "calculations.h"
int main() {
double a = 10.0;
double b = 5.0;
std::cout << a << " + " << b << " = " << Math::add(a, b) << std::endl;
std::cout << a << " - " << b << " = " << Math::subtract(a, b) << std::endl;
std::cout << a << " * " << b << " = " << Math::multiply(a, b) << std::endl;
std::cout << a << " / " << b << " = " << Math::divide(a, b) << std::endl;
return 0;
}g++ -c library/src/calculations.cpp -I library/include -o calculations.o
g++ app/calculator.cpp calculations.o -I library/include -o calculator./calculator正しい出力が表示されるはずです。
10 + 5 = 15
10 - 5 = 5
10 * 5 = 50
10 / 5 = 2この例は、宣言と実装の適切な分離、名前空間、および正しいコンパイルとリンクを示しています。これらのプラクティスに従うことで、ほとんどの未定義シンボルエラーを回避できます。
この実験（Lab）では、C++ プログラムで未定義シンボルエラーを診断し、解決する方法を学びました。あなたは現在、以下を理解しています。
nm や ldd などのツールを使用した高度なデバッグテクニックによるシンボル問題の特定と修正これらのスキルは、C++ 開発者にとって不可欠です。未定義シンボルエラーは、コンパイルとリンク中に遭遇する最も一般的な問題の 1 つです。これらのエラーを体系的に分析し、適切な修正を適用することで、ビルド時の問題が少ない、より堅牢な C++ アプリケーションを開発できます。
宣言と実装の一貫性を保ち、名前空間を使用してコードを適切に整理し、ライブラリを扱う際にはリンクプロセスを理解するなどのベストプラクティスに従うことを忘れないでください。これらのツールとテクニックにより、C++ プロジェクトで未定義シンボルエラーを処理するための十分な準備ができました。
