c++ - 如何向后移植 Qt 中的功能？

Question

假设有一个使用 Qt 的项目，并且依赖于 Qt 新版本中存在的功能(例如添加的类成员)。该项目旨在使用 Qt 的“系统”/发行版本进行构建，该版本可能比项目所依赖的版本更旧。

天真的方法会导致预处理器 hell :

void Class::foo() {
#if QT_VERSION >= QT_VERSION_CHECK(...)
  QClass::newFangled();
#else
  QClass::oldFangled1();
  blurble();
#endif
}

是否有一种更简洁的方法，在使用该功能时不依赖于预处理器宏？ IE。我们不想要:

// THIS IS BLAH
#if QT_VERSION >= QT_VERSION_CHECK(...)
#define QClass_newFangled QClass::newFangled
#else
#define QClass_newFangled [this]{ \
   QClass::oldFangled1(); \
   blurble(); \
}
#endif
void Class::foo() {
  QClass_newFangled();
}

Answer 1

一种可行的方法是在自定义命名空间中使用给定的类或全局函数。该命名空间中的类/函数可以从 Qt 导入而无需更改，或者是向后移植所需功能的自定义类/函数。

下面的代码是 Qt 命名空间感知的:它将与命名空间 Qt 构建一起使用。

在使用时，在 compat 命名空间中访问向后移植的功能(全局函数和类)，即

void test() {
  ...
  qDebug() << compat::qEnvironmentVariableIntValue("RUNMODE");
  compat::QTimer::singleShot(1000, object, []{ ... });
}

请注意，将带有默认参数的函数/方法添加到 compat 命名空间时，默认参数仅在 C++17 及更高版本中传播。否则，我们必须自己通过定义转发函数/方法来处理它们。

向后移植全局函数

假设我们要从 Qt 5.5 向后移植 qEnvironmentVariableIntValue:

// INTERFACE

namespace compat {
#if QT_VERSION >= QT_VERSION_CHECK(5,5,0)
#if __cplusplus >= 201703L
using QT_PREPEND_NAMESPACE(qEnvironmentVariableIntValue); // C++17
#else
int inline qEnvironmentVariableIntValue(const char *varName, bool *ok = {}) {
  return QT_PREPEND_NAMESPACE(qEnvironmentVariableIntValue)(varName, ok);
}
#endif
#else
int qEnvironmentVariableIntValue(const char *varName, bool *ok = {});
#endif
} // compat

// IMPLEMENTATION

namespace compat {
#if QT_VERSION < QT_VERSION_CHECK(5,5,0)
using QT_PREPEND_NAMESPACE(qgetenv); // C++17
int qEnvironmentVariableIntValue(const char *varName, bool *ok) {
  return qgetenv(varName).toInt(ok, 0);
}
#endif // Qt<5.5
} // compat

向后移植到类中

假设我们想要向后移植 Qt 5.4 的 QTimer::singleShot(int, QObject*, Functor)，动机是 this answer :

// INTERFACE

namespace compat {
#if QT_VERSION >= QT_VERSION_CHECK(5,4,0)

using QT_PREPEND_NAMESPACE(QTimer);

#else

using Q_QTimer = QT_PREPEND_NAMESPACE(QTimer);
class QTimer : public Q_QTimer {
  Q_OBJECT
public:
  #if __cplusplus >= 201703L
  using Q_QTimer::Q_QTimer; // C++17
  #else
  QTimer(QObject *parent = {}) : Q_QTimer(parent) {}
  #endif
  template <class Functor> static void singleShot(int, QObject *, Functor &&);
};

template <class Functor>
void QTimer::singleShot(int msec, QObject *context, Functor &&fun) {
  ...
}

#endif
} // compat