opaque struct——c/c++如何隱藏內部結構體的定義?
學習過VLC的童鞋都會看得類似這樣的程式碼:
/** This structure is opaque. It represents a libvlc instance */
typedef struct libvlc_instance_t libvlc_instance_t;
但是怎麼也找不到libvlc_instance_t的定義,難道說libvlc_instance_t沒有定義嗎?不是的,其實libvlc_instance_t
是定義了的,在一個“私有的標頭檔案”中定義的。看一個例子就明白來。
1、建立一個動態庫工程,名為libOpaqueStruct,
libOpaqueStruct.h為工程自動生成的程式碼,保留內容如下:
//libOpaqueStruct.h
#ifdef LIBOPAQUESTRUCT_EXPORTS
#define LIBOPAQUESTRUCT_API __declspec(dllexport)
#else
#define LIBOPAQUESTRUCT_API __declspec(dllimport)
#endif
2、新增內部結構體定義標頭檔案
//__opaque_def.h
#ifndef __OPAQUE_DEF_H
#define __OPAQUE_DEF_H
struct opaque_test
{
int firstData;
int secondData;
};
#endif
3、新增對外介面定義標頭檔案
//opaque_def.h
#ifndef OPAQUE_DEF_H
#define OPAQUE_DEF_H
#include "libOpaqueStruct.h"
typedef struct opaque_test opaque_test;
LIBOPAQUESTRUCT_API opaque_test * opaque_test_new();
LIBOPAQUESTRUCT_API void opaque_test_set(opaque_test * p_opaque_test, int v1, int v2);
LIBOPAQUESTRUCT_API void opaque_test_print(const opaque_test * p_opaque_test);
LIBOPAQUESTRUCT_API void opaque_test_delete(opaque_test * p_opaque_test);
#endif //OPAQUE_DEF_H
4、新增實現檔案
//opaque_def.cpp
#include "__opaque_def.h"
#include "opaque_def.h"
#include <iostream>
using namespace std;
opaque_test * opaque_test_new()
{
return new opaque_test();
}
void opaque_test_set(opaque_test * p_opaque_test, int v1, int v2)
{
if (p_opaque_test != NULL)
{
p_opaque_test->firstData = v1;
p_opaque_test->secondData = v2;
}
}
void opaque_test_print(const opaque_test * p_opaque_test)
{
if (p_opaque_test != NULL)
{
cout << "the first data is "
<< p_opaque_test->firstData
<< " and the second data is "
<< p_opaque_test->secondData
<< endl;
}
}
void opaque_test_delete(opaque_test * p_opaque_test)
{
delete p_opaque_test;
p_opaque_test = NULL;
}
5、最後編譯,生成libOpaqueStruct.dll和libOpaqueStruct.lib
編譯中,如果報錯,在工程屬性中,取消預編譯即可。
下面來呼叫我們的dll
6、建立一個控制檯程式名為test,把標頭檔案(opaque_def.h和libOpaqueStruct.h)放到./libOpaueStruct/inc/下面,
把lib檔案(libOpaqueStruct.lib)放到./libOpaueStruct/lib/下面,dll放到生成的test.exe中,把libOpaqueStruct.lib配到你的工程中去。
這些是最基本的東西,相信你懂的。
//test.cpp
#include "stdafx.h"
#include "libOpaueStruct/inc/opaque_def.h"
#include <iostream>
using namespace std;
int _tmain(int argc, _TCHAR* argv[])
{
opaque_test * p_opaque_test = opaque_test_new();
opaque_test_set(p_opaque_test, 5, 6);
opaque_test_print(p_opaque_test);
system("pause");
opaque_test_delete(p_opaque_test);
return 0;
}
7、編譯test,執行,螢幕上顯示:
the first data is 5 and the second data is 6
從這個例子,可以學習到如何隱藏內部結構體的定義,Windows API應該就是這樣實現的。在今後的工作中,也這樣寫dll吧。
大神裝,裝大神!^v^