Microsoft MVP성태의 닷넷 이야기
C/C++: 166. C/C++ - DLL에서 template 함수를 export하는 방법 [링크 복사], [링크+제목 복사],
조회: 12286
글쓴 사람
정성태 (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*로 받은다음에 캐스팅하는 방식을 써봤는데
전자는 타입추가될때마다 인스턴스를 추가해줘야되서 번거롭고
후자는 캐스팅하는 귀찮음이 있더라고요
일단 후자로 하고있긴한데 뭐가 맞는지 모르겠네요ㅎㅎ
괴물신인

[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13980정성태7/31/202557Linux: 119. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ (2)
13979정성태7/30/2025182Linux: 118. eBPF - BPF_PROG_TYPE_CGROUP_SOCK 유형에서 정상 동작하지 않는 BPF_CORE_READ
13978정성태7/29/2025258오류 유형: 970. 파일 복사 시 "Data error (cyclic redundancy check). (0x80070017)" 에러
13977정성태7/28/2025384닷넷: 2349. C# 14 - (5) 문자열 리터럴을 utf-8 인코딩으로 저장파일 다운로드1
13976정성태7/25/2025571닷넷: 2348. C# - 카카오 카나나 모델 + Microsoft.ML.OnnxRuntimeGenAI 예제파일 다운로드1
13975정성태7/23/2025730닷넷: 2347. C# 14 - (4) 형식 인자가 없는 제네릭 타입의 nameof 지원파일 다운로드1
13974정성태7/22/2025902닷넷: 2346. C# 14 - (3) Span 타입과 배열 간의 암시적 형변환파일 다운로드1
13973정성태7/21/2025855닷넷: 2345. C# - 배열 및 Span의 공변성파일 다운로드1
13972정성태7/21/20251175닷넷: 2344. C#의 Identity conversion 의미파일 다운로드1
13971정성태7/17/20251404닷넷: 2343. C# 14 - (2) 속성 구문에서 문맥 키워드로 추가되는 field 예약어파일 다운로드1
13970정성태7/17/20251381닷넷: 2342. C# 14 - (1) (예약)
13969정성태7/17/20251430닷넷: 2341. snap으로 설치한 .NET 리눅스 실행 환경
13968정성태7/16/20251310오류 유형: 969. lddtree - TypeError: 'type' object is not subscriptable
13967정성태7/16/20251823오류 유형: 968. snap으로 설치한 "dotnet run" 실행 시 "undefined symbol: _dl_audit_symbind_alt, version GLIBC_PRIVATE" 오류
13966정성태7/15/20252362디버깅 기술: 223. WinDbg - .kframes 명령어
13965정성태7/11/20251654오류 유형: 967. 디버깅 모드로 실행 시 "Could not find file 'C:\Program Files\IIS Express\Oracle.DataAccess.Common.Configuration.Section.xsd'" 예외
13964정성태7/10/20252318닷넷: 2340. C# - Win32 Multimedia Timer 주기파일 다운로드1
13963정성태7/8/20251871VS.NET IDE: 202. Visual Studio 2022 + Copilot 기본 사용법
13962정성태7/7/20251889스크립트: 79. 파이썬 - onnxruntime_genai에서 지원하지 않는 모델 사용
13961정성태7/5/20251594디버깅 기술: 222. WinDbg 분석 사례 - IISreset 시점에 w3wp.exe의 crash 발생
13960정성태7/3/20252776개발 환경 구성: 752. ProcDump - C/C++ 예외 코드 필터를 지정한 덤프 생성 [2]
13959정성태6/25/20251732오류 유형: 966. Ubuntu - ping: connect: Network is unreachable
13958정성태6/21/20252449닷넷: 2339. C# - Phi-4-multimodal 모델의 GPU 가속 방법 (ORT 사용)파일 다운로드1
13957정성태6/20/20252906닷넷: 2338. C# / Foundry Local - Phi-4-multimodal 모델을 사용하는 방법 [1]
13956정성태6/19/20252633개발 환경 구성: 751. Triton Inference Server의 Python Backend 프로세스
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...