17

如果我正在创建一个带有如下头文件的静态库：

// Myfile.h

#include "SomeHeaderFile.h" // External library

Class MyClass
{

// My code

};

在我自己的项目中，我可以告诉编译器（在我的例子中是 Visual Studio）在哪里寻找 SomeHeaderFile.h。但是，我不希望我的用户关心这一点——他们应该能够包含我的头文件，而不必通知他们的编译器 SomeHeaderFile.h 的位置。

这种情况一般如何处理？

4

2 回答 2

16

这是一个经典的“编译防火墙”场景。有两个简单的解决方案：

  1. 从外部库前向声明您需要的任何类或函数。然后仅在您的 cpp 文件中包含外部库的头文件（当您实际需要使用您在头文件中前向声明的类或函数时）。

  2. 使用 PImpl 成语（或 Cheshire Cat），您可以在其中前向声明一个“实现”类，该类您仅私下声明和定义（在 cpp 文件中）。您使用该私有类来放置所有依赖于外部库的代码，以避免在您的公共类（在您的头文件中声明的那个）中有任何痕迹。

这是使用第一个选项的示例：

#ifndef MY_LIB_MY_HEADER_H
#define MY_LIB_MY_HEADER_H

class some_external_class;  // forward-declare external dependency.

class my_class {
  public:
    // ...
    void someFunction(some_external_class& aRef);  // declare members using the forward-declared incomplete type.
};

#endif

// in the cpp file:

#include "my_header.h"
#include "some_external_header.h"

void my_class::someFunction(some_external_class& aRef) {
  // here, you can use all that you want from some_external_class.
};

以下是选项 2 的示例：

#ifndef MY_LIB_MY_HEADER_H
#define MY_LIB_MY_HEADER_H

class my_class_impl;  // forward-declare private "implementation" class.

class my_class {
  private:
    std::unique_ptr<my_class_impl> pimpl; // a vanishing facade...
  public:
    // ...
};

#endif

// in the cpp file:

#include "my_header.h"
#include "some_external_header.h"

class my_class_impl {
  private:
    some_external_class obj;
    // ...
  public:
    // some functions ... 
};

my_class::my_class() : pimpl(new my_class_impl()) { };
于 2012-12-20T19:25:30.843 回答
4

假设外部头文件包含以下内容：

外部.h

class foo
{
public:
   foo();
};

在您的库中，您使用 foo：

我的头文件.h：

#include "external.h"

class bar
{
...
private:
   foo* _x;
};

要编译您的代码，您所要做的就是转发声明 foo 类（之后您可以删除包含）：

class foo;

class bar
{
...
private:
   foo* _x;
};

然后，您必须在源文件中包含 external.h。

于 2012-12-20T19:21:16.420 回答