CKTIS / C++
Ligação de linguagem C: `extern "C"`
`extern "C"` especifica a ligação de linguagem para a interoperabilidade entre C e C++. Não ativa o modo C do compilador nem garante, por si só, a compatibilidade binária.
Versão: ISO C++23; implementation support may vary
Sintaxe
extern "C" int cktis_answer(void);
extern "C" {
typedef int cktis_answer_fn(void);
int cktis_other_answer(void);
}Em C++23, extern "C" é uma especificação de ligação de linguagem. Pode aplicar-se a uma declaração ou a um grupo de declarações entre chavetas. Só é permitida no âmbito de um espaço de nomes; as chavetas não criam um âmbito novo. Se houver especificações aninhadas, aplica-se a mais interior. A ligação de linguagem predefinida é C++.
A ligação de linguagem de um nome é independente da ligação de um tipo de função. A primeira diz respeito a nomes de funções e variáveis com ligação externa e pode afetar a representação dos símbolos para o ligador. A segunda pode afetar a convenção de chamada e faz parte do tipo de função para o qual aponta um ponteiro de callback. Segundo a norma, dois tipos de função de resto idênticos são distintos se um tiver ligação C e o outro C++. Nem todos os compiladores os distinguem; não dependa de sobrecargas baseadas apenas nessa diferença.
Duas funções cujos nomes têm ligação C não podem formar um conjunto de sobrecargas com o mesmo nome, ainda que tenham listas de parâmetros ou espaços de nomes diferentes. A pesquisa de nomes em C++ continua a respeitar os espaços de nomes, mas declarações homónimas de funções com ligação C em espaços diferentes podem designar a mesma função. Uma redeclaração sem especificação herda a ligação. Especificações contraditórias para a mesma entidade tornam o programa malformado; não é exigido um diagnóstico se nenhuma declaração for alcançável a partir da outra.
extern "C" não ativa o modo C, não transforma classes em tipos C nem altera a disposição dos objetos em memória. Num cabeçalho partilhado por C e C++, proteja a sintaxe extern "C" com #ifdef __cplusplus, para que C só veja declarações compatíveis com C. Use assinaturas coincidentes e uma ABI compatível (as regras de interoperabilidade binária) de ambos os lados. A especificação, por si só, não garante um nome de símbolo exato nem a sua exportação a partir de uma biblioteca partilhada.
Na fronteira com C, capture as exceções de C++ do lado de C++ e comunique os erros, por exemplo, com um código de estado. Se a interface passar ponteiros para dados, especifique quem detém os dados e durante quanto tempo os ponteiros são válidos.
Exemplos
#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
A definição de `api::cktis_answer` herda a ligação C e usa `std::array` no corpo. `callback` aponta para a função `api::cktis_answer`. O nome `api::cktis_answer_fn`, introduzido por `typedef`, designa o tipo dessa função com ligação C. O resultado esperado é `42`; o exemplo não é ligado a uma unidade de tradução C compilada separadamente.
Lições relacionadas
- C++ · Lição 56 · Avançado · Versão: 3