C++. Сборник рецептов

для А. Это требуется для того, чтобы компилятор мог проверить сигнатуру используемой функции-члена А или тип переменной-члена А. Вот иллюстрация кода, требующего #include.

#include 'a.h'
class B {
public:
 void f(const A& a) {
  foo_ = a.getVal(); // требуется знать, допустимо ли a.getVal
 }
}
// ...

В общем случае используйте предварительное объявление тогда, когда это позволяет снизить количество #include, что отражается на времени компиляции.

2.4. Предотвращение конфликта имен с помощью пространств имен

Проблема

В несвязанных между собой модулях обнаружены конфликтующие имена или требуется заранее избежать возможности таких конфликтов, создав логические группы кода.

Решение

Для структурирования кода используйте пространства имен. С помощью пространств имен можно объединять большие группы кода, находящиеся в разных файлах, в единое пространство имен. Для разбиения больших модулей на подмодули можно использовать вложенные пространства имен, и потребители вашего модуля смогут выборочно открывать элементы вашего пространства имен, которые им требуются. Пример 2.5 показывает несколько способов использования пространства имен.

Пример 2.5. Использование пространств имен

// Devices.h
#ifndef DEVICES_H__
#define DEVICES_H__
#include <string>
#include <list>
namespace hardware {
 class Device {
 public:
  Device(): uptime_(0), status_('unknown') {}
  unsigned long getUptime() const;
  std::string getStatus() const;
  void reset();
 private:
  unsigned long uptime_;
  std::string status_;
 };
 class DeviceMgr {
 public:
  void getDeviceIds(std::list<std::string>& ids) const;
  Device getDevice(const std::string& id) const;
  // Other stuff...
 };
}
#endif // DEVICES_H__
// Devices.cpp
#include 'Devices.h'
#include <string>
#include <list>
namespace hardware {
 using std::string;
 using std::list;
 unsigned long Device::getUptime() const {
  return(uptime__);
 }
 string Device::getStatus() const {
  return(status_);
 }
 void DeviceMgr::getDeviceIds(list<string>& ids) const {}
 Device DeviceMgr::getDevice(const string& id) const {
  Device d;
  return(d);
 }
}
// DeviceWidget.h
#ifndef DEVICEWIDGET_H__ #define DEVICEWIDGET_H__
#include 'Devices.h'
namespace ui {
 class Widget {/*... */ };
 class DeviceWidget : public Widget {
 public:
  DeviceWidget(const hardware::Device& dev) : device_(dev) {}
  // Some other stuff
 protected:
  hardware::Device device_;
 };
}