[C++ DLL] C++ 클래스를 DLL로 만들고 사용하기 (예제 포함)

본문을 읽기 전에 아래의 링크를 참고하면 이해하는데 도움이 됩니다.

[C++ DLL] Visual Studio C++ DLL 생성하기 (예제 포함)

[C++ DLL] Visual Studio C++ 암시적 링크하기 (예제 포함)

[C++ DLL] Visual Studio C++ 명시적 링크하기 (예제 포함)

C++ 클래스를 DLL로 만들기

지금까지 C++ 함수를 DLL로 만들어(Export) 외부 프로젝트에서 호출(Import)하는 방법을 알아보았는데요. 그런데 Class 객체는 어떻게 DLL로 만들 수 있을까요? 아래 코드 예시와 같이 말이죠.

//DLL 생성 프로젝트의 헤더
class Person {
public:
	Person(std::string name, int age, std::string address);
	void ShowInfo();

private:
	int age;
	std::string name;
	std::string address;
};

//DLL을 호출하는 외부 프로젝트
Person person1("홍길동", 26, "서울시");
Person1.ShowInfo();

보통 클래스 객체를 사용하면 14번째 줄과 같이 객체를 선언하고, 15번째 줄과 같이 객체에 접근하여 함수를 호출하는데요. 함수 이름 앞에 __declspec(dllexport) 키워드를 붙이듯이, 클래스 이름에 붙여 보았지만 안되더군요. 나중에 소개할 MFC 확장 DLL에서는 AFX_EXT_CLASS 키워드를 클래스 이름 앞에 붙이면, 위 코드 예시와 같이 선언하고 호출할 수 있습니다.

이번 포스팅에서는 생각과는 조금 다르지만, C++ 클래스를 DLL로 Export 하는 방법을 소개하겠습니다. 예제 코드는 본문의 하단에 첨부되어 있습니다.

C++ Class DLL Export 방법

본문에서 제시할 방법은 아주 간단합니다. 클래스 객체를 생성하고 반환하는 팩토리 함수를 만들고, 반환된 객체로 인자를 받고 특정 멤버 함수를 호출하는 함수들을 정의하는 것입니다.

MyDLL.h 코드를 보겠습니다.

#pragma once

#include <string>
#include <iostream>

#ifdef CREATEDLL_EXPORTS
#define MYDLL_DECLSPEC __declspec(dllexport)
#else
#define MYDLL_DECLSPEC __declspec(dllimport)
#endif

class Person {
public:
	Person(std::string name, int age, std::string address);
	void ShowInfo();

private:
	int age;
	std::string name;
	std::string address;
};

extern "C" {
	MYDLL_DECLSPEC Person* CreatePerson(char* name, int age, char* address);
	MYDLL_DECLSPEC void ShowInfo(Person* obj);
	MYDLL_DECLSPEC void DeletePerson(Person* obj);
}

다음은 MyDLL.cpp입니다.

#include "pch.h"
#include "MyDLL.h"

Person::Person(std::string name, int age, std::string address) {
	this->age = age;
	this->name = name;
	this->address = address;
}

void Person::ShowInfo() {
	std::cout << "이름: " << name << std::endl;
	std::cout << "나이: " << age << std::endl;
	std::cout << "주소: " << address << std::endl;
}

Person* CreatePerson(char* name, int age, char* address)
{
	std::cout << "Person 객체 생성" << std::endl;
	return new Person(name, age, address);
}

void ShowInfo(Person* obj)
{
	obj->ShowInfo();
}

void DeletePerson(Person* obj)
{
	delete obj;
	obj = nullptr;

	std::cout << "Person 객체 해제" << std::endl;
}

Person Class가 MyDLL.h에 정의되어 있고, 몸체는 MyDLL.cpp에 구현되어 있습니다. 팩토리 함수인 CreatePerson() 함수는 인자로 기본 정보를 넘겨받고, new Person()을 통해 생성된 객체를 반환합니다. 그리고 이렇게 반환된 객체 포인터를 이용하여 객체의 멤버 함수를 호출할 수 있습니다. ShowInfo(Person* obj)처럼 말이죠. 마지막으로 객체를 더 이상 사용하지 않는다면 DeletePerson(Person* obj)을 호출하여 해제해 줘야 합니다.

DLL을 호출하는 프로젝트의 MainDLL.cpp 코드를 보겠습니다.

#include "../CreateDLL/MyDLL.h"
#pragma comment (lib, "../x64/Debug/CreateDLL.lib")

int main()
{
	char name[] = "홍길동";
	char address[] = "서울시";
	
	Person* person1 = CreatePerson(name, 35, address);
	ShowInfo(person1);
	DeletePerson(person1);
	
	getchar();
}

팩토리 함수인 CreatePerson()을 호출하여 Person객체의 포인터를 반환받습니다. 그리고 그 객체 포인터를 이용하여 ShowInfo()를 호출할 수 있고, 사용이 끝나면 DeletePerson()을 호출하여 메모리를 해제하는 것입니다. 실행 결과는 아래와 같습니다.

실행 결과

만약, 아래와 같이 클래스 멤버 함수에 접근하면 에러가 발생합니다.

#include "../CreateDLL/MyDLL.h"
#pragma comment (lib, "../x64/Debug/CreateDLL.lib")

int main()
{
	char name[] = "홍길동";
	char address[] = "서울시";
	
	Person* person1 = CreatePerson(name, 35, address);
	person1->ShowInfo(); // LNK2019
}

클래스 정보 자체가 Export된 것이 아니기 때문에 참조할 수 없기 때문입니다.

LNK2019 에러

이렇게 구현하면 클래스 객체를 DLL로 만들어 외부에서 사용할 수 있습니다. 자세한 사용 방법은 아래 예제 코드를 참고해 주세요.

ExamDLL.zip

0.01MB

이어서 다음 포스팅에서는 MFC 확장 DLL로 쉽게 클래스 객체를 DLL로 만들고, 외부에서 어떻게 사용하는지 소개하겠습니다.