Empaquetar la API de clase C++ para el consumo de C

Mientras que la respuesta de Loki Astari es muy buena, su código de ejemplo coloca el código de envoltura dentro de la clase C++. Prefiero tener el código de empaquetado en un archivo separado. También creo que es mejor estilo para prefijar las funciones de envoltura C con el nombre de la clase.

Las siguientes entradas del blog muestran cómo hacer eso: http://blog.eikke.com/index.php/ikke/2005/11/03/using_c_classes_in_c.html

Copié la parte esencial porque el blog está abandonado y finalmente podría desaparecer (crédito a El blog de Ikke):

Primero necesitamos una clase C++, usando un archivo de encabezado (Test.hh)

class Test {
    public:
        void testfunc();
        Test(int i);

    private:
        int testint;
};

Y un archivo de implementación (Test.cc)

#include <iostream>
#include "Test.hh"

using namespace std;

Test::Test(int i) {
    this->testint = i;
}

void Test::testfunc() {
    cout << "test " << this->testint << endl;
}

Esto es solo código básico de C++.

Entonces necesitamos algún código de pegamento. Este código es algo entre C y C++. Una vez más, tenemos un archivo de encabezado (TestWrapper.h, solo .h ya que no contiene ningún código C++)

typedef void CTest;

#ifdef __cplusplus
extern "C" {
#endif

CTest * test_new(int i);
void test_testfunc(const CTest *t);
void test_delete(CTest *t);
#ifdef __cplusplus
}
#endif

Y las implementaciones de funciones (TestWrapper.cc,. cc ya que contiene código C++):

#include "TestWrapper.h"
#include "Test.hh"

extern "C" {

    CTest * test_new(int i) {
        Test *t = new Test(i);

        return (CTest *)t;
    }

    void test_testfunc(const CTest *test) {
        Test *t = (Test *)test;
        t->testfunc();
    }

    void test_delete(CTest *test) {
        Test *t = (Test *)test;

        delete t;
    }
}

Primero, es posible que no necesite convertir todos sus métodos a funciones C. Si puede simplificar la API y ocultar parte de la interfaz de C++, es mejor, ya que minimiza la posibilidad de cambiar la API de C cuando cambia la lógica de C++ detrás.

Así que piense en una abstracción de nivel superior que se proporcionará a través de esa API. Utilice la solución void * que ha descrito. Me parece el más apropiado (o typedef void* como HANDLE:)).

Algunas opiniones de mi experiencia:

• las funciones deben devolver códigos para representar errores. Es útil tener una función que devuelve la descripción del error en forma de cadena. Todos los demás valores devueltos deben ser parámetros out.

Ej:

C_ERROR BuildWidget(HUI ui, HWIDGET* pWidget);

• coloque las firmas en las estructuras/clases a las que su puntero se dirige para comprobar la validez de los controladores.

Por ejemplo, su función debería tener el siguiente aspecto:

C_ERROR BuildWidget(HUI ui, HWIDGET* pWidget){
    Ui* ui = (Ui*)ui;
    if(ui.Signature != 1234)
    return BAD_HUI;
}

• los objetos deben ser creados y liberado usando funciones exportadas desde DLL, ya que el método de asignación de memoria en DLL y la aplicación consumidora pueden diferir.

Ej:

C_ERROR CreateUi(HUI* ui);
C_ERROR CloseUi(HUI hui); // usually error codes don't matter here, so may use void

• si está asignando memoria para algún búfer u otros datos que puedan ser necesarios para persistir fuera de su biblioteca, proporcione el tamaño de este búfer/datos. De esta manera, los usuarios pueden guardarlo en el disco, la base de datos o donde quieran sin piratear sus componentes internos para averiguar el tamaño real. De lo contrario, eventualmente tendrá que proporcionar su propia api de E/S de archivos qué usuarios usarán solo para convertir sus datos a una matriz de bytes de tamaño conocido.

Ej:

C_ERROR CreateBitmap(HUI* ui, SIZE size, char** pBmpBuffer, int* pSize);

• si sus objetos tienen alguna representación típica fuera de su biblioteca de C++, proporcione un medio de conversión a esta representación (por ejemplo, si tiene alguna clase Image y proporciona acceso a ella a través de HIMG handle, proporcione funciones para convertirla hacia y desde, por ejemplo, windows HBITMAP). Esto simplificará la integración con la API existente.

Por ejemplo

C_ERROR BitmapToHBITMAP(HUI* ui, char* bmpBuffer, int size, HBITMAP* phBmp);

Utilice vector (y string::c_str) para intercambiar datos con API que no sean de C++. (Directriz # 78 de Estándares de Codificación C++ , H. Sutter / A. Alexandrescu).

PS No es tan cierto que "los constructores pueden conservar su lista de argumentos original". Esto solo es cierto para los tipos de argumentos que son compatibles con C.

PS2 Por supuesto, escucha Cătălin y mantén tu interfaz lo más pequeña y simple posible.

Esto puede ser de interés: "Mezcla de C y C++" en C++ FAQ Lite. Específicamente [32.8] ¿Cómo puedo pasar un objeto de una clase C++ a/desde una función C?