Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

Linkage di linguaggio C: `extern "C"`

`extern "C"` specifica il linkage di linguaggio per l’interoperabilità tra C e C++. Non passa alla modalità C e non garantisce da solo la compatibilità binaria.

Versione: ISO C++23; implementation support may vary

Sintassi

extern "C" int cktis_answer(void);

extern "C" {
    typedef int cktis_answer_fn(void);
    int cktis_other_answer(void);
}

In C++23, extern "C" è una specifica di linkage di linguaggio. Si può applicare a una singola dichiarazione o a un gruppo di dichiarazioni tra parentesi graffe. È ammessa solo nell’ambito di un namespace; le graffe non creano un nuovo ambito. Se le specifiche sono annidate, vale quella più interna. Il linkage di linguaggio predefinito è C++.

Il linkage di linguaggio di un nome e quello di un tipo di funzione sono distinti. Il primo riguarda i nomi di funzioni e variabili con linkage esterno e può influire su come i loro simboli sono rappresentati per il linker. Il secondo può influire sulla convenzione di chiamata e fa parte del tipo di funzione a cui punta un puntatore di callback. Per lo standard, due tipi di funzione altrimenti identici sono distinti se uno ha linkage C e l’altro C++. Non tutti i compilatori li distinguono: non fare affidamento su overload basati solo su questa differenza.

Due funzioni con nomi a linkage C non possono formare un insieme di overload sotto lo stesso nome, nemmeno con liste di parametri o namespace diversi. La ricerca dei nomi in C++ rispetta ancora i namespace, ma dichiarazioni omonime di funzioni con linkage C in namespace diversi possono indicare la stessa funzione. Una ridichiarazione senza specifica eredita il linkage. Specifiche in conflitto per la stessa entità rendono il programma mal formato; non è richiesta una diagnosi se nessuna delle due dichiarazioni è raggiungibile dall’altra.

extern "C" non attiva la modalità C, non trasforma le classi in tipi C e non modifica la disposizione degli oggetti in memoria. In un header condiviso tra C e C++, proteggi la sintassi extern "C" con #ifdef __cplusplus, affinché C veda solo dichiarazioni compatibili con C. Usa firme corrispondenti e un’ABI compatibile (le regole di interoperabilità binaria) su entrambi i lati. La specifica da sola non garantisce né un nome esatto del simbolo né la sua esportazione da una libreria condivisa.

Al confine con C, intercetta le eccezioni C++ sul lato C++ e segnala gli errori, ad esempio con un codice di stato. Se l’interfaccia passa puntatori a dati, specifica chi possiede i dati e per quanto tempo i puntatori restano validi.

Esempi

#include <array>
#include <iostream>

namespace api {
extern "C" {
    typedef int cktis_answer_fn(void);
    int cktis_answer(void);
}

int cktis_answer(void) {
    const std::array<int, 2> parts{19, 23};
    return parts[0] + parts[1];
}
}

int main() {
    api::cktis_answer_fn* callback = &api::cktis_answer;
    std::cout << callback() << '\n';
}

Risultato

42

La definizione di `api::cktis_answer` eredita il linkage C e usa `std::array` nel corpo. `callback` punta alla funzione `api::cktis_answer`. Il nome `api::cktis_answer_fn`, introdotto con `typedef`, indica il tipo con linkage C di quella funzione. L’output atteso è `42`; l’esempio non viene collegato a un’unità di traduzione C compilata separatamente.

Lezioni correlate

  • C++ · Lezione 56 · Avanzato · Versione: 3

Fonti