pragma weak

#pragma weak 是 C 和 C++ 語言裡宣告 weak symbol 的方式, 在 C 和 C++ 的規範中並未定義 weak symbol 的使用, 所以只好使用 #pragma 來支援, 而這就會有不 portable 的問題 (各平台狀況不一樣)。

#pragma weak symbol_name

int symbol_name(int x);

weak symbol 為 ELF 在 linking 時的一種標示, 一般的狀況下 symbol 都是 strong 的, 但是可以特別指定某些 symbol 為 weak, 如此一來在 linking 的時候,同樣名字的 strong symbol 可以蓋掉 weak symbol, 不然兩個同名的 strong symbol 一起出現會造成 link-time error。 在 linking 執行檔時,weak symbol 可以沒有 definition,但是 strong symbol 一定要有 definition, 不然會有 undefined symbol 的錯誤。

藉由 weak symbol 的方式, 程式可以提供預設的實作, 並且可以在 link-time 時提供被換掉的可能性 (換成該平台上效能更好的實作), 或者可以做客制化。

程式的 symbols 可以使用 nm 這個指令來觀看, 有 definition 的 weak function symbol 會標 “W”, 沒有 definition 的 weak function symbol 會標 “w”, weak variable symbol 會標 “V” 或 “v”, 範例:

// hello.c

#include <stdio.h>

#pragma weak hello
#pragma weak hello_var

int hello_var;

void hello () {
    printf("Hello World!\n");
}

int main () {
    hello();
    return 0;
}
$ gcc hello.c -o hello
$ nm hello | grep hello
0000000000400596 W hello
00000000004019dc V hello_var

Reference