Microsoft MVP성태의 닷넷 이야기
C/C++: 166. C/C++ - DLL에서 template 함수를 export하는 방법 [링크 복사], [링크+제목 복사],
조회: 9911
글쓴 사람
정성태 (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)
13935정성태5/20/2025310파이썬 - pip 사용 시 "ImportError: cannot import name 'html5lib' from 'pip._vendor'" 오류
13934정성태5/20/2025338스크립트: 77. 파이썬 - 'urllib.request' 모듈의 명시적/암시적 로딩 차이
13933정성태5/19/2025467오류 유형: 956. Visual Studio 2022가 17.12 버전부터 업데이트 되지 않는다면?
13932정성태5/18/2025517스크립트: 76. 파이썬 - Version 문자열 다루기(semver 패키지)
13931정성태5/17/2025908스크립트: 75. 파이썬 - Cython 기본 예제 및 컴파일
13930정성태5/17/2025833개발 환경 구성: 744. 파이썬 - Windows embeddable package 환경에서 외부 패키지 사용하는 방법(ex: UFO² 환경 구성)
13929정성태5/16/20251001오류 유형: 955. 파이썬 - "Windows embeddable package" REPL 환경에서 "NameError: name 'exit' is not defined"
13928정성태5/15/20251151오류 유형: 954. UFO² - "'Invalid URL (POST /v1/chat/completions/chat/completions)'"
13927정성태5/15/20251162오류 유형: 953. OpenAI - The API request of HOST_AGENT failed: OpenAI API request exceeded rate limit: Error code: 429
13926정성태5/14/20251574개발 환경 구성: 743. LLM과 윈도우의 만남 - Desktop AgentOS UFO² 기본 환경 구성
13925정성태5/12/20251661닷넷: 2333. C# - (Console 유형의 프로젝트에서) Clipboard 연동파일 다운로드1
13924정성태5/8/20251428닷넷: 2332. C# - (JetBrains Omea Reader 대상으로) 런타임 시에 메서드 가로채기 [2]파일 다운로드1
13923정성태5/5/20251224스크립트: 74. 파이썬 - C# - Python.NET의 RunSimpleScript, Exec, Eval 차이점파일 다운로드1
13922정성태5/3/20251351스크립트: 73. 파이썬 - Windows embeddable package 버전에서 tkinter 환경 구성
13921정성태5/3/20251610오류 유형: 952. 듀얼 채널 메모리 정렬을 지키지 않은 컴퓨터의 Windows 비정상 종료 현상(Blue Screen) [2]
13920정성태5/3/20251652오류 유형: 951. Typed DataSet 생성 중 "Failed to open a connection to the database" 오류
13919정성태5/2/20251519VS.NET IDE: 201. C# - Typed DataSet(XSD)를 위한 연결 문자열 암호화 [1]파일 다운로드1
13918정성태5/2/20251622VS.NET IDE: 200. C# - app.config 파일의 출력을 Configuration(Debug/Release)에 따라 제어하는 방법파일 다운로드1
13917정성태4/30/20251314VS.NET IDE: 199. Directory.Build.props에 정의한 속성에 대해 Condition 제약으로 값을 변경하는 방법
13916정성태4/23/20251117디버깅 기술: 221. WinDbg 분석 사례 - ASP.NET HttpCookieCollection을 다중 스레드에서 사용할 경우 무한 루프 현상 - 두 번째 이야기
13915정성태4/13/20252430닷넷: 2331. C# - 실행 시에 메서드 가로채기 (.NET 9)파일 다운로드1
13914정성태4/11/20252809디버깅 기술: 220. windbg 분석 사례 - x86 ASP.NET 웹 응용 프로그램의 CPU 100% 현상 (4)
13913정성태4/10/20251654오류 유형: 950. Process Explorer - 64비트 윈도우에서 32비트 프로세스의 덤프를 뜰 때 "Error writing dump file: Access is denied." 오류
13912정성태4/9/20251386닷넷: 2330. C# - 실행 시에 메서드 가로채기 (.NET 5 ~ .NET 8)파일 다운로드1
13911정성태4/8/20251670오류 유형: 949. WinDbg - .NET Core/5+ 응용 프로그램 디버깅 시 sos 확장을 자동으로 로드하지 못하는 문제
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...