undefined reference to の原因と直し方|コンパイルは通るのにリンクで落ちる【C言語】
C言語
gcc
エラー
どんなエラーか
sqrt (平方根)を使ったプログラムを、いつもどおり gcc u1.c でコンパイルします。
#include <stdio.h>
#include <math.h>
int main(void) {
double x;
scanf("%lf", &x);
printf("%f\n", sqrt(x));
return 0;
}gcc 13(Ubuntu)の実際の出力です。
/usr/bin/ld: /tmp/cciCC38y.o: in function `main':
u1.c:(.text+0x40): undefined reference to `sqrt'
collect2: error: ld returned 1 exit status#include <math.h> は書いてあるのにエラーになります。ポイントは1行目の /usr/bin/ld と、最後の ld returned 1 exit status です。ld(リンカ)が出しているエラーで、ソースの文法の間違いではありません。
コンパイルとリンクは別の作業
gcc u1.c の1回のコマンドの中で、実は2つの作業が動いています。
と書いた紙だけ
(いつも自動で探す)
(-lm を付けないと探さない)
#include は「こういう関数がある」という宣言だけ。本体はライブラリの中にあり、リンクのときに探す。
コンパイル:1ファイルずつ文法を調べて、機械語(.o ファイル)にします。 #include <math.h> で「 sqrt という関数がある」と宣言されていれば、ここは通ります。
リンク:.o ファイルとライブラリを集めて、呼び出している関数の本体を探し、1つの実行ファイルにします。本体が見つからないと undefined reference to になります。
関数の「宣言」と「本体」の違いは、C言語入門の関数の話でも出てきます。
パターン1:数学関数で -lm を付け忘れた
sqrt ・ pow ・ sin ・ log などの本体は、数学ライブラリ(libm)に入っています。Linux の gcc では、libm は自動では探さないので -lm を付けます。
$ gcc u1.c -lm
$ echo 2 | ./a.out
1.414214-lm はソースファイルより後ろに書きます。 gcc -lm u1.c の順だと、環境によっては同じエラーのままです(リンカは前から順に読み、その時点で必要な関数だけを取り出すため)。
パターン2:別ファイルの関数を渡し忘れた
main を u2main.c、 add を u2add.c に分けて書いたのに、u2main.c だけをコンパイルした場合です。
// u2main.c
#include <stdio.h>
int add(int a, int b);
int main(void) {
printf("%d\n", add(2, 3));
return 0;
}$ gcc u2main.c
/usr/bin/ld: /tmp/ccYKUfxL.o: in function `main':
u2main.c:(.text+0x13): undefined reference to `add'
collect2: error: ld returned 1 exit statusadd の宣言(1行のプロトタイプ)はあるのでコンパイルは通りますが、本体は u2add.c の中です。両方を渡せば通ります。
$ gcc u2main.c u2add.c
$ ./a.out
5VS Code の「実行ボタン」や Code Runner は、開いている1ファイルだけをコンパイルする設定のことが多いです。ファイルを分けたらターミナルで両方を渡すか、 tasks.json の引数を ${fileDirname}/*.c のように変えます。
パターン3:関数名のタイプミス
hello を呼ぶつもりで helo と書いた場合です。
u3.c: In function 'main':
u3.c:6:5: warning: implicit declaration of function 'helo'; did you mean 'hello'? [-Wimplicit-function-declaration]
6 | helo();
| ^~~~
| hello
/usr/bin/ld: /tmp/cctY6iOq.o: in function `main':
u3.c:(.text+0xe): undefined reference to `helo'
collect2: error: ld returned 1 exit statusリンクのエラーの前に、 implicit declaration of function の警告が出ています。警告を読むと did you mean 'hello'? と答えまで書いてあります。上に出ている警告から順に読むのが近道です。この警告については「implicit declaration of function」の記事でも書いています。
パターン4:undefined reference to `main'
main の綴りや大文字小文字を間違えると、こう出ます。
/usr/bin/ld: /usr/lib/gcc/x86_64-linux-gnu/13/../../../x86_64-linux-gnu/Scrt1.o: in function `_start':
(.text+0x1b): undefined reference to `main'
collect2: error: ld returned 1 exit statusプログラムは main から始まる決まりなので、 Main ・ mian ・ main のないファイルだけをコンパイルした、のどれかです。
エラーの名前からの見分け方
| undefined reference to の後ろ | よくある原因 | 直し方 |
|---|---|---|
sqrt pow sin log | 数学ライブラリを付けていない | 最後に -lm |
| 自分で作った関数 | 本体を書いたファイルを渡していない/本体を書き忘れた | gcc a.c b.c のように全部渡す |
| 少し違う名前 | タイプミス(警告に did you mean が出る) | 名前をそろえる |
main | main の綴り・大文字 | int main(void) に直す |
pthread_create など | そのライブラリを付けていない | -pthread など、マニュアルにある指定を付ける |
Mac では「Undefined symbols」と出る
Mac の clang では、同じ原因でも文言が違います。
Undefined symbols for architecture arm64:
"_add", referenced from:
_main in u2main-xxxx.o
ld: symbol(s) not found for architecture arm64名前の前に _ が付いていますが、意味は同じで「 add の本体が見つからない」です。
まとめ
undefined reference to は、コンパイルではなくリンクのエラー
宣言(#include やプロトタイプ)はあるが、本体が見つからない
数学関数は -lm 、分けたファイルは全部渡す、名前のミスは上の警告を読む
ほかのエラーは、stray '\343' in program、makes pointer from integer without a cast、format '%d' expects argument of type でまとめています。
C言語でよく出るエラーはC言語 エラー一覧にまとめています。