Microsoft MVP성태의 닷넷 이야기
C/C++: 166. C/C++ - DLL에서 template 함수를 export하는 방법 [링크 복사], [링크+제목 복사],
조회: 10572
글쓴 사람
정성태 (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)
13952정성태6/15/2025236닷넷: 2336. C# - IValueTaskSource로 인해 주의가 필요한 ValueTask 호출파일 다운로드1
13951정성태6/15/2025211오류 유형: 963. Outlook - 일정이 "You cannot make changes to contents of this read-only folder." 오류 메시지로 삭제가 안 되는 경우
13950정성태6/12/20251010닷넷: 2335. C# - 간단하게 구현해 보는 IValueTaskSource 예제파일 다운로드1
13949정성태6/11/2025855오류 유형: 962. SignTool - "Error: SignerSign() failed." (-2146869243/0x80096005)
13948정성태6/10/2025591오류 유형: 961. 파이썬 - Linux 환경 + TCP 서버 소켓을 사용하는 프로세스 종료 후 재실행하는 경우 "OSError: [Errno 98] Address already in use" 오류 발생
13947정성태6/9/20251346개발 환경 구성: 750. 파이썬 - Azure App Service에 응용 프로그램 배포 후의 환경
13946정성태6/9/20251572개발 환경 구성: 749. 파이썬 - Azure App Service에 응용 프로그램 배포하기 전의 환경
13945정성태6/7/20251519오류 유형: 960. 파이썬 + conda - mysqlclient 사용 시 "NameError: name '_mysql' is not defined" 에러
13944정성태6/7/20255251오류 유형: 959. The trust relationship between this workstation and the primary domain failed. - 네 번째 이야기
13943정성태6/6/20251716개발 환경 구성: 748. Windows + Foundry Local - 로컬에서 AI 모델 활용
13942정성태6/5/20251392오류 유형: 958. winget 설치 시 "0x80d02002 : unknown error"
13941정성태6/2/20251333닷넷: 2334. C# - cpuid 명령어를 이용한 CPU 제조사 문자열 가져오기파일 다운로드1
13940정성태6/1/20251718C/C++: 188. C++의 32비트 + Release 어셈블리 코드를 .NET으로 포팅할 때 주의할 점파일 다운로드1
13939정성태5/29/20252093오류 유형: 957. NVIDIA Triton Inference Server - version `GLIBCXX_3.4.32' not found (required by /opt/tritonserver/backends/python/triton_python_backend_stub)
13938정성태5/29/20251627개발 환경 구성: 747. 파이썬 - WSL/docker에 구성한 Triton 예제 개발 환경
13937정성태5/24/20251519개발 환경 구성: 746. Windows + WSL2 환경에서 (tensorflow 등의) NVIDIA GPU 인식
13936정성태5/23/20251354개발 환경 구성: 745. Linux / WSL 환경에 Miniconda 설치하기
13935정성태5/20/20251318파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
13934정성태5/20/20251830스크립트: 77. 파이썬 - 'urllib.request' 모듈의 명시적/암시적 로딩 차이
13933정성태5/19/20251437오류 유형: 956. Visual Studio 2022가 17.12 버전부터 업데이트 되지 않는다면?
13932정성태5/18/20251676스크립트: 76. 파이썬 - Version 문자열 다루기(semver 패키지)
13931정성태5/17/20251984스크립트: 75. 파이썬 - Cython 기본 예제 및 컴파일
13930정성태5/17/20251683개발 환경 구성: 744. 파이썬 - Windows embeddable package 환경에서 외부 패키지 사용하는 방법(ex: UFO² 환경 구성)
13929정성태5/16/20251769오류 유형: 955. 파이썬 - "Windows embeddable package" REPL 환경에서 "NameError: name 'exit' is not defined"
13928정성태5/15/20251728오류 유형: 954. UFO² - "'Invalid URL (POST /v1/chat/completions/chat/completions)'"
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...