Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

Jazyková vazba C: `extern "C"`

`extern "C"` určuje jazykovou vazbu pro spolupráci kódu v C a C++. Nepřepíná překladač do režimu C a samo o sobě nezaručuje binární kompatibilitu.

Verze: 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);
}

V C++23 je extern "C" specifikace jazykové vazby. Může platit pro jednu deklaraci nebo pro skupinu deklarací ve složených závorkách. Smí se použít jen v oboru jmenného prostoru; závorky nezakládají nový obor platnosti. Při vnoření rozhoduje nejvnitřnější specifikace. Výchozí je jazyková vazba C++.

Jazyková vazba jména a jazyková vazba typu funkce jsou nezávislé. První se týká jmen funkcí a proměnných s vnější vazbou a může ovlivnit zápis symbolů pro linker. Druhá může ovlivnit konvenci volání a je součástí typu funkce, na který ukazuje ukazatel na zpětné volání. Podle normy jsou jinak shodné typy funkcí s vazbou C a C++ různé. Ne všechny překladače je rozlišují, proto na tomto jediném rozdílu nezakládej přetěžování.

Dvě funkce se stejně pojmenovanými názvy s vazbou C nemohou tvořit množinu přetížení, ani když mají různé seznamy parametrů nebo jsou v různých jmenných prostorech. Vyhledávání jmen v C++ se stále řídí jmennými prostory, ale stejnojmenné deklarace funkcí s vazbou C v různých jmenných prostorech mohou označovat tutéž funkci. Opakovaná deklarace bez specifikace vazbu zdědí. Rozporné specifikace pro tutéž entitu jsou nepřípustné; diagnostika není vyžadována, pokud ani jedna deklarace není dosažitelná z druhé.

extern "C" nepřepíná do režimu C, nemění třídy na typy jazyka C ani nemění rozložení objektů v paměti. Ve společném hlavičkovém souboru pro C a C++ skryj syntaxi extern "C" za podmínku #ifdef __cplusplus, aby C vidělo jen deklarace kompatibilní s C. Na obou stranách používej odpovídající signatury a kompatibilní ABI (pravidla spolupráce binárního kódu). Specifikace sama nezaručuje přesnou podobu jména symbolu ani jeho export ze sdílené knihovny.

Na rozhraní s C zachyť výjimky C++ na straně C++ a chyby oznam například stavovým kódem. Pokud rozhraní předává ukazatele na data, urči, kdo data vlastní a jak dlouho ukazatele zůstávají platné.

Příklady

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

Výsledek

42

Definice `api::cktis_answer` zdědí vazbu C a v těle používá `std::array`. `callback` ukazuje na funkci `api::cktis_answer`. Jméno `api::cktis_answer_fn` zavedené pomocí `typedef` označuje typ této funkce s vazbou C. Očekávaný výstup je `42`; příklad se nespojuje se samostatně přeloženou překladovou jednotkou v C.

Související lekce

  • C++ · Lekce 56 · Pokročilá · Verze: 3

Zdroje