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