Что делает extern "C" в C++ и зачем он нужен при работе с C библиотеками?

Что такое extern "C" — простое объяснение

extern "C" — это директива компоновщику (линкеру), которая говорит: "используй для этой функции правила именования из языка C, а не из C++". Это критически важно, потому что C++ и C по-разному обрабатывают имена функций при компиляции.

Проблема: Name Mangling (искажение имен)

В C++ есть перегрузка функций (overloading) — вы можете определить несколько функций с одинаковым именем, но разными параметрами:

void print(int x);      // версия для int
void print(double x);   // версия для double
void print(const char* s); // версия для строки

Компилятору нужно как-то различать эти функции на уровне объектного кода. Поэтому C++ компилятор искажает (mangles) имена, добавляя информацию о типах параметров. Например, в компиляторе GCC эти функции могут получить внутренние имена:

• _Z5printi — для void print(int)
• _Z5printd — для void print(double)
• _Z5printPKc — для void print(const char*)

В C нет перегрузки, поэтому имена функций остаются такими, как вы их написали — просто print.

Что происходит без extern "C"?

Допустим, у вас есть библиотека, написанная на C, которая предоставляет функцию foo. Вы подключаете заголовочный файл:

// Файл: clib.h (написан на C)
void foo(int x);

Когда вы компилируете C++ код, который вызывает foo, компилятор создает ссылку на _Z3fooi (искаженное имя). Но в объектном файле C-библиотеки эта функция называется просто foo. Линкер не может их соединить — получаете ошибку "undefined reference to _Z3fooi".

Решение: extern "C"

Директива extern "C" отключает искажение имени для указанных функций:

extern "C" {
    void foo(int x);
    int bar(const char* s);
}

Теперь компилятор создаст ссылку на foo, а не на _Z3fooi, и линковка с C-библиотекой пройдет успешно.

Зачем #ifdef __cplusplus?

Этот макрос определен только при компиляции C++ кодом. Если вы используете один и тот же заголовочный файл в C и C++ проектах, обертка гарантирует, что:

• В C++ — будет применено extern "C" (нужно для правильной линковки).
• В C — конструкция extern "C" будет проигнорирована, так как C не поддерживает этот синтаксис.

Без #ifdef C-компилятор выдал бы ошибку на extern "C".

Можно ли использовать extern "C" для C++ функций?

Да, это работает и в обратную сторону. Если вы хотите, чтобы C++ функция была доступна из C-кода:

// mylib.hpp
#ifdef __cplusplus
extern "C" {
#endif

int my_cpp_function(double value);

#ifdef __cplusplus
}
#endif

// mylib.cpp
#include "mylib.hpp"
int my_cpp_function(double value) {
    // C++ код здесь (можете использовать STL, классы и т.д.)
    return static_cast<int>(value * 2);
}

Но есть важное ограничение: внутри такой функции вы не можете передавать C++-специфичные типы (например, std::string, ссылки, исключения) через границу C/C++. Только POD-типы (int, double, указатели, структуры без методов).

Практический пример ошибки

Представьте, что вы используете библиотеку SQLite (написанную на C). Без extern "C":

#include <sqlite3.h>  // Внутри там extern "C" есть

int main() {
    sqlite3* db;
    sqlite3_open("test.db", &db); // Если бы не было extern "C" — ошибка линковки!
    sqlite3_close(db);
    return 0;
}

Вот почему все C-библиотеки, предназначенные для использования в C++, обязательно оборачивают свои объявления в extern "C".

// Ошибка компиляции!
extern "C" template<typename T>
void foo(T x);

template<typename T>
void foo(T x) { /* ... */ }

extern "C" {
    void foo_int(int x) { foo(x); }  // Обертка
}