Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

Enlace de lenguaje C: `extern "C"`

`extern "C"` especifica el enlace de lenguaje para que C y C++ puedan interoperar. No activa el modo C del compilador ni garantiza por sí solo la compatibilidad binaria.

Versión: ISO C++23; implementation support may vary

Sintaxis

extern "C" int cktis_answer(void);

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

En C++23, extern "C" es una especificación de enlace de lenguaje. Puede aplicarse a una declaración o a un grupo de declaraciones entre llaves. Solo se permite en el ámbito de un espacio de nombres; las llaves no crean un ámbito nuevo. Si se anidan especificaciones, se aplica la más interna. El enlace de lenguaje predeterminado es C++.

El enlace de lenguaje de un nombre es independiente del enlace de un tipo de función. El primero afecta a los nombres de funciones y variables con enlace externo y puede influir en cómo se representan sus símbolos para el enlazador. El segundo puede influir en la convención de llamada y forma parte del tipo de función al que apunta un puntero de callback. Según el estándar, dos tipos de función por lo demás idénticos son distintos si uno tiene enlace C y el otro C++. No todos los compiladores los distinguen, así que no bases una sobrecarga solo en esa diferencia.

Dos funciones cuyos nombres tienen enlace C no pueden formar un conjunto de sobrecargas con el mismo nombre, ni siquiera con listas de parámetros o espacios de nombres distintos. La búsqueda de nombres en C++ sigue respetando los espacios de nombres, pero las declaraciones homónimas de funciones con enlace C en espacios distintos pueden designar la misma función. Una redeclaración sin especificación hereda el enlace. Las especificaciones contradictorias para una misma entidad hacen que el programa esté mal formado; no se exige un diagnóstico si ninguna declaración es alcanzable desde la otra.

extern "C" no activa el modo C, no convierte clases en tipos C ni cambia la disposición de los objetos en memoria. En una cabecera compartida, protege la sintaxis extern "C" con #ifdef __cplusplus para que C solo vea declaraciones compatibles con C. Usa firmas coincidentes y una ABI compatible (las reglas de interoperabilidad binaria) en ambos lados. La especificación por sí sola no garantiza un nombre de símbolo exacto ni su exportación desde una biblioteca compartida.

En la frontera con C, captura las excepciones de C++ en el lado de C++ y comunica los errores, por ejemplo, mediante un código de estado. Si la interfaz pasa punteros a datos, especifica quién es su propietario y cuánto tiempo siguen siendo válidos los punteros.

Ejemplos

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

Resultado

42

La definición de `api::cktis_answer` hereda el enlace C y usa `std::array` en su cuerpo. `callback` apunta a la función `api::cktis_answer`. El nombre `api::cktis_answer_fn`, introducido mediante `typedef`, designa el tipo de esa función, que tiene enlace C. La salida esperada es `42`; el ejemplo no se enlaza con una unidad de traducción C compilada por separado.

Lecciones relacionadas

  • C++ · Lección 56 · Avanzado · Versión: 3

Fuentes