Сборка, линковка и ABI

// report.cpp после препроцессинга фактически содержит
#include "report.hpp"
#include <vector>
#include <string>
int build_report() { /* ... */ }

// file.cpp
namespace {
int parse_impl(std::string_view text) {
    return static_cast<int>(text.size());
}
}

static int checksum(const Buffer& b) {
    return checksum_bytes(b.data(), b.size());
}

// header
int calculate(int);
// client.cpp
int x = calculate(3);

// a.cpp
#define MODE 1
#include "config.hpp"
// b.cpp
#define MODE 2
#include "config.hpp"
// config.hpp определяет inline-функцию в зависимости от MODE

extern int global_count;          // объявление
int compute(int);                 // объявление

int global_count = 0;             // определение
int compute(int x) { return x; }  // определение

g++ -c parser.cpp -o parser.o
g++ -c main.cpp -o main.o
g++ main.o parser.o -o app
# последний шаг разрешает ссылки между объектными файлами

# app.o использует parse(), определённую в libparser.a
g++ app.o -lparser -lcore -o app
# перестановка архивов может изменить разрешение символов

// a.cpp
int version() { return 1; }
// b.cpp
int version() { return 2; }
// linker видит два сильных определения version()

# сборка shared library
-fvisibility=hidden

class API_EXPORT Client {
public:
    void send(Request);
};

// header
struct X { int value() const; };
// cpp
int X::value() { return 1; }

void process(int);
void process(std::string_view);
namespace net { void process(Packet const&); }
// ABI кодирует различия сигнатур в символах

extern "C" int plugin_version();
extern "C" void* create_plugin(const HostApi* host);
// C language linkage влияет на связывание имён и типов функций

extern "C" void process(int);
extern "C" void process(double); // две функции с C linkage и одним именем

$ nm libservice.so | grep create
00000000000131a0 T _ZN7service6createENS_6ConfigE
$ c++filt _ZN7service6createENS_6ConfigE

// одна и та же исходная сигнатура в разных ABI/toolchain
std::string render(const Document&);
// конкретное кодированное имя не является межплатформенным контрактом

// версия 1 публичного заголовка
class Session { int fd_; };
// версия 2
class Session { int fd_; std::uint64_t trace_id_; };
// клиент выделяет sizeof(Session), известный при своей компиляции

// Библиотека A собрана с одной стандартной библиотекой.
extern "C" void consume_name(const std::string& name);

// Приложение B передаёт объект, созданный своим runtime.
std::string name = read_name();
consume_name(name);

// lib.cpp
std::string make_name();

// app.cpp
std::cout << make_name();

// lib и app собраны с разными значениями
// _GLIBCXX_USE_CXX11_ABI.