정의되지 않은 심볼 오류는 C++ 프로그래밍에서 흔히 발생하는 문제로, 컴파일 및 링크 과정에서 초보자를 혼란스럽게 합니다. 이러한 오류는 컴파일러가 코드에서 사용되는 함수 또는 변수의 구현을 찾을 수 없을 때 발생합니다. 이 Lab 에서는 실질적인 실습 예제를 통해 다양한 유형의 정의되지 않은 심볼 오류를 식별하고, 이해하며, 해결하는 방법을 배우게 됩니다.
이 Lab 을 마치면 컴파일 및 링크 프로세스, 정의되지 않은 심볼 오류의 일반적인 원인, 그리고 C++ 프로젝트에서 이러한 문제를 진단하고 해결하기 위한 효과적인 전략에 대한 확실한 이해를 갖게 될 것입니다.
이 단계에서는 정의되지 않은 심볼 오류가 무엇인지 살펴보고, 이러한 오류가 발생하는 방식을 보여주는 간단한 예제를 만들어 보겠습니다.
정의되지 않은 심볼 오류는 일반적으로 컴파일의 링크 단계에서 발생하며, 링커가 코드에서 선언되고 사용되는 함수 또는 변수의 구현을 찾을 수 없을 때 나타납니다. C++ 컴파일 프로세스는 여러 단계로 구성됩니다.
링커가 심볼 참조를 해결할 수 없을 때, "정의되지 않은 심볼 (undefined symbol)" 또는 "정의되지 않은 참조 (undefined reference)" 오류를 생성합니다.
정의되지 않은 심볼 오류를 보여주는 간단한 예제를 만들어 보겠습니다. 두 개의 파일을 만들 것입니다.
먼저, 헤더 파일을 만들어 보겠습니다. 편집기에서 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;
}이제 구현 파일이 있으므로 모든 소스 파일을 함께 컴파일해야 합니다. 이를 수행하는 두 가지 주요 방법이 있습니다.
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;
}라이브러리를 사용하는 데는 두 가지 옵션이 있습니다.
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) 있습니다.정의되지 않은 심볼 오류의 또 다른 일반적인 원인은 네임스페이스 및 스코프 문제입니다. 이 단계에서는 이러한 문제가 어떻게 정의되지 않은 심볼 오류로 이어질 수 있는지, 그리고 이를 해결하는 방법을 살펴보겠습니다.
네임스페이스 관련 정의되지 않은 심볼 오류를 보여주는 예제를 만들어 보겠습니다. 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 지시문/선언을 사용합니다. |
| 스코프 제한 | 심볼이 호출 스코프에서 접근 가능한지 확인합니다. |
| 심볼 이름 맹글링 (Symbol name mangling) | 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이 예제는 선언과 구현의 적절한 분리, 네임스페이스, 올바른 컴파일 및 링크를 보여줍니다. 이러한 관행을 따르면 대부분의 정의되지 않은 심볼 오류를 방지할 수 있습니다.
이 랩에서는 C++ 프로그램에서 정의되지 않은 심볼 오류를 진단하고 해결하는 방법을 배웠습니다. 이제 다음 사항을 이해하게 되었습니다.
nm 및 ldd와 같은 도구를 사용하여 심볼 문제를 식별하고 수정하는 고급 디버깅 기술이러한 기술은 C++ 개발자에게 필수적입니다. 정의되지 않은 심볼 오류는 컴파일 및 링크 중에 발생하는 가장 일반적인 문제 중 하나이기 때문입니다. 이러한 오류를 체계적으로 분석하고 적절한 수정을 적용함으로써 빌드 시간 문제가 적은 더 강력한 C++ 애플리케이션을 개발할 수 있습니다.
선언과 구현을 일관되게 유지하고, 네임스페이스로 코드를 적절하게 구성하고, 라이브러리로 작업할 때 링크 프로세스를 이해하는 것과 같은 모범 사례를 따르는 것을 잊지 마십시오. 이러한 도구와 기술을 통해 이제 C++ 프로젝트에서 정의되지 않은 심볼 오류를 처리할 수 있는 충분한 역량을 갖추게 되었습니다.
