Microsoft MVP성태의 닷넷 이야기
C/C++: 166. C/C++ - DLL에서 template 함수를 export하는 방법 [링크 복사], [링크+제목 복사],
조회: 12392
글쓴 사람
정성태 (seongtaejeong at gmail.com)
홈페이지
첨부 파일
(연관된 글이 1개 있습니다.)

C/C++ - DLL에서 template 함수를 export하는 방법

아래의 Q&A에서,

템플릿 대체할수있는방법이 있을까요?
; https://www.sysnet.pe.kr/3/0/5939

template 함수를 DLL에 export할 수 없다는 의견이 나오는데, 절반은 맞고 절반은 틀립니다. ^^ 이게 뭔 소리냐면, template 함수도 구현 코드를 cpp로 분리하는 것은 가능하지만,

// Dll1.h
#define DLL1_API __declspec(dllexport)

template<typename ObjectType> DLL1_API ObjectType* CreateObject();

// Dll1.cpp

template<typename ObjectType>
DLL1_API ObjectType* CreateObject()
{
    ObjectType* NewObj = new ObjectType();
    return NewObj;
}

저렇게 만들어진 DLL은 CreateObject 함수를 "__declspec(dllexport)"이 지정되었음에도 export하지는 못합니다. 그럴 수밖에 없는 것이, template에 전달되는 타입 정보는 컴파일 시점에 정해져, 같은 시점에 소스코드가 생성돼 함께 컴파일되는 것이므로 실행 시 DLL Export의 함수를 바인딩한다면 이것을 연결할 만한 mangling 이름 규칙이 없기 때문입니다.

만약 template을 위한 mangling 이름 규칙을 정의한다면, DLL은 그 스스로 함수 바인딩 시에 전달된 타입 정보를 기반으로 template 함수를 런타임 시에 생성해 내는 방법을 제공해야 합니다. C#과 같은 VM 계열의 언어라면 런타임 측에서 그런 것을 할 수도 있지만 C/C++과 같은 native 언어는 방법이 없습니다.

이에 대한 보완으로, Visual C++의 경우 template 함수에 대해서는 타입 정보를 미리 명시적으로 지정하여 export 할 수 있게 해주는데요, 다소 원시적일 수 있지만 어쩔 수 없습니다. ^^

// Dll1.h

template<typename ObjectType> DLL1_API ObjectType* CreateObject();

class CMyClass2
{
public:
    int n = 5;
    const char* ptr = "Hello";
};

template DLL1_API CMyClass2* CreateObject<CMyClass2>();
template DLL1_API int* CreateObject<int>();

저렇게라도 하면 Visual C++은 명시된 타입 정보에 해당하는 template을 구체화시켜 코드를 만들어내 미리 빌드해 놓습니다. 따라서, 이제 DLL의 export 함수 테이블에는 이에 해당하는 함수가 등록되고,

c:\temp> dumpbin Dll1.dll /EXPORTS
    ...[생략]...

          1    0 0001123A ??$CreateObject@H@@YAPEAHXZ = @ILT+565(??$CreateObject@H@@YAPEAHXZ)
          2    1 00011064 ??$CreateObject@VCMyClass2@@@@YAPEAVCMyClass2@@XZ = @ILT+95(??$CreateObject@VCMyClass2@@@@YAPEAVCMyClass2@@XZ)

이렇게 export한 함수의 이름을 각각 풀어보면,

c:\temp> undname ??$CreateObject@H@@YAPEAHXZ
...[생략]...

Undecoration of :- "??$CreateObject@H@@YAPEAHXZ"
is :- "int * __ptr64 __cdecl CreateObject(void)"

c:\temp> undname ??$CreateObject@VCMyClass2@@@@YAPEAVCMyClass2@@XZ
...[생략]...

Undecoration of :- "??$CreateObject@VCMyClass2@@@@YAPEAVCMyClass2@@XZ"
is :- "class CMyClass2 * __ptr64 __cdecl CreateObject(void)"

타입별로 템플릿 함수가 export된 것을 확인할 수 있습니다. 결국, 사용 측에서는 다음과 같이 해당 함수로 바인딩할 수 있고,

#include <iostream>

#include "../Dll1/Dll1.h"

#pragma comment(lib, "../x64/Debug/Dll1.lib")

int main()
{
    CMyClass2* cmc = CreateObject<CMyClass2>();
    std::cout << cmc->n << " " << cmc->ptr; // 출력 결과: 5 Hello
}

만약 다른 타입을 사용하려고 하면,

unsigned int* n1 = CreateObject<unsigned int>();

DLL 측에는 "unsigned int"로 CreateObject 함수를 미리 만들어 둔 것이 없기 때문에 "unsigned int * __cdecl CreateObject<unsigned int>(void)" mangling 이름을, 즉 "(__imp_??$CreateObject@I@@YAPEAIXZ)" 함수를 찾지 못해 에러가 발생합니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 7/13/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2024-09-03 08시24분
질문작성자인데 이 글을 이제봤네요 ㄷㄷ
이 글처럼 타입별로 인스턴스화하는 방식이랑
void*로 받은다음에 캐스팅하는 방식을 써봤는데
전자는 타입추가될때마다 인스턴스를 추가해줘야되서 번거롭고
후자는 캐스팅하는 귀찮음이 있더라고요
일단 후자로 하고있긴한데 뭐가 맞는지 모르겠네요ㅎㅎ
괴물신인

... [91]  92  93  94  95  96  97  98  99  100  101  102  103  104  105  ...
NoWriterDateCnt.TitleFile(s)
11720정성태10/4/201826038개발 환경 구성: 405. Hyper-V 가상 머신에서 직렬 포트(Serial Port, COM Port) 사용
11719정성태10/4/201826708.NET Framework: 796. C# - 인증서를 윈도우에 설치하는 방법
11718정성태10/4/201821689개발 환경 구성: 404. (opkg가 설치된) Synology NAS(DS216+II)에 cmake 설치
11717정성태10/3/201823855사물인터넷: 48. 넷두이노의 C# 네트워크 프로그램 [1]
11716정성태10/3/201825006사물인터넷: 47. Raspberry PI Zero (W)에 FTDI 장치 연결 후 C/C++로 DTR 제어파일 다운로드1
11715정성태10/3/201822866사물인터넷: 46. Raspberry PI Zero (W)에 docker 설치
11714정성태10/2/201822981사물인터넷: 45. Raspberry PI에 ping을 hostname으로 하는 방법
11713정성태10/2/201824018개발 환경 구성: 403. Synology NAS(DS216+II)에 docker 설치 후 .NET Core 2.1 응용 프로그램 실행하는 방법
11712정성태10/2/201829591.NET Framework: 795. C# - 폰트 목록을 한글이 아닌 영문으로 구하는 방법 [3]
11711정성태10/2/201824818오류 유형: 490. 윈도우 라이선스 키 입력 오류 0xc004f050, 0xc004e028
11710정성태10/2/201824108.NET Framework: 794. C# - 같은 모양, 다른 값의 한글 자음을 비교하는 호환 분해 [5]
11709정성태9/30/201822853개발 환경 구성: 402. .NET Core 콘솔 응용 프로그램을 docker로 실행/디버깅하는 방법 [1]
11708정성태9/30/201825949개발 환경 구성: 401. .NET Core 콘솔 응용 프로그램을 배포(publish) 시 docker image 자동 생성 [2]파일 다운로드1
11707정성태9/30/201827299오류 유형: 489. ASP.NET Core를 docker에서 실행 시 "Failed with a critical error." 오류 발생 [1]
11706정성태9/29/201822120개발 환경 구성: 400. Synology NAS(DS216+II)에서 실행한 gcc의 Segmentation fault [2]
11705정성태9/29/201822717개발 환경 구성: 399. Synology NAS(DS216+II)에 gcc 컴파일러 설치
11704정성태9/29/201828100기타: 73. Synology NAS 신호음(beep) 끄기 [1]파일 다운로드1
11703정성태9/27/201821191개발 환경 구성: 398. Blazor 환경 구성 후 빌드 속도가 너무 느리다면? [2]
11702정성태9/26/201819058사물인터넷: 44. 넷두이노(Netduino)의 네트워크 설정 방법
11701정성태9/26/201824925개발 환경 구성: 397. 공유기를 일반 허브로 활용하는 방법파일 다운로드1
11700정성태9/21/201824090Graphics: 25. Unity - shader의 직교 투영(Orthographic projection) 행렬(UNITY_MATRIX_P)을 수작업으로 구성
11699정성태9/21/201822220오류 유형: 488. Add-AzureAccount 실행 시 "No subscriptions are associated with the logged in account in Azure Service Management (RDFE)." 오류
11698정성태9/21/201823671오류 유형: 487. 윈도우 성능 데이터를 원격 SQL에 저장하는 경우 "Call to SQLAllocConnect failed with %1." 오류 발생
11697정성태9/20/201820866Graphics: 24. Unity - unity_CameraWorldClipPlanes 내장 변수 의미
11696정성태9/19/201823198.NET Framework: 793. C# - REST API를 이용해 NuGet 저장소 제어파일 다운로드1
11695정성태9/19/201828454Graphics: 23. Unity - shader의 원근 투영(Perspective projection) 행렬(UNITY_MATRIX_P)을 수작업으로 구성
... [91]  92  93  94  95  96  97  98  99  100  101  102  103  104  105  ...