Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

Liaison de langage C : `extern "C"`

`extern "C"` spécifie la liaison de langage pour l’interopérabilité entre C et C++. Il ne fait pas passer le compilateur en mode C et ne suffit pas à garantir la compatibilité binaire.

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

Syntaxe

extern "C" int cktis_answer(void);

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

En C++23, extern "C" est une spécification de liaison de langage. Elle s’applique à une déclaration ou à un groupe de déclarations entre accolades. Elle ne s’emploie que dans la portée d’un espace de noms ; ses accolades ne créent pas de portée. En cas d’imbrication, la spécification la plus interne s’applique. La liaison de langage par défaut est celle de C++.

La liaison de langage d’un nom et celle d’un type de fonction sont distinctes. La première concerne les noms de fonctions et de variables à liaison externe et peut influer sur la représentation de leurs symboles pour l’éditeur de liens. La seconde peut influer sur la convention d’appel et fait partie du type de fonction visé par un pointeur de rappel. La norme distingue deux types de fonction par ailleurs identiques si l’un a la liaison C et l’autre la liaison C++. Tous les compilateurs ne les distinguent pas : ne comptez pas sur une surcharge qui repose uniquement sur cette différence.

Deux fonctions dont les noms ont la liaison C ne peuvent pas former un ensemble de surcharges sous le même nom, même si leurs listes de paramètres ou leurs espaces de noms diffèrent. La recherche de noms en C++ tient toujours compte des espaces de noms, mais des déclarations homonymes de fonctions à liaison C dans des espaces différents peuvent désigner la même fonction. Une redéclaration sans spécification hérite de la liaison. Des spécifications contradictoires pour une même entité rendent le programme mal formé ; aucun diagnostic n’est exigé si aucune déclaration n’est atteignable depuis l’autre.

extern "C" ne sélectionne pas le mode C, ne transforme pas les classes en types C et ne modifie pas la disposition des objets en mémoire. Dans un en-tête commun à C et C++, protégez la syntaxe extern "C" avec #ifdef __cplusplus afin que C ne voie que des déclarations compatibles avec C. Utilisez des signatures concordantes et une ABI compatible (les règles d’interopérabilité binaire) des deux côtés. La spécification seule ne garantit ni l’orthographe exacte d’un symbole ni son export depuis une bibliothèque partagée.

À la frontière avec C, interceptez les exceptions C++ du côté C++ et signalez les erreurs, par exemple avec un code d’état. Si l’interface transmet des pointeurs vers des données, précisez qui possède ces données et combien de temps les pointeurs restent valides.

Exemples

#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';
}

Résultat

42

La définition de `api::cktis_answer` hérite de la liaison C et utilise `std::array` dans son corps. `callback` pointe vers la fonction `api::cktis_answer`. Le nom `api::cktis_answer_fn`, introduit par `typedef`, désigne le type à liaison C de cette fonction. La sortie attendue est `42` ; aucune unité de traduction C compilée séparément n’est liée à cet exemple.

Leçons associées

  • C++ · Leçon 56 · Avancé · Version : 3

Sources