Qt qOverload函数介绍

Qt qOverload函数介绍

函数原型

auto qOverload(T functionPointer)

详细介绍

该函数返回一个指向重载函数的指针，其中的模板参数是重载函数参数类型的列表（list）。functionPointer是重载函数（成员函数）的指针：

  struct Foo {
      void overloadedFunction();
      void overloadedFunction(int, QString);
  };
  ... qOverload<>(&Foo::overloadedFunction)
  ... qOverload<int, QString>(&Foo::overloadedFunction)

如果其中有成员函数是const-overloaded类型的，则必须使qConstOverload 和qNonConstOverload，而不是，例如：

  struct Foo {
      void overloadedFunction(int, QString);
      void overloadedFunction(int, QString) const;
  };
  ... qConstOverload<int, QString>(&Foo::overloadedFunction)
  ... qNonConstOverload<int, QString>(&Foo::overloadedFunction)

qOverload()需要C++14的支持。在C++11风格的代码中，QOverload、 QConstOverload和QNonConstOverload类也可以直接这样使用：

  ... QOverload<>::of(&Foo::overloadedFunction)
  ... QOverload<int, QString>::of(&Foo::overloadedFunction)

**注意：**Qt会根据《C++ Committee’s Standing Document 6》中的特征测试推荐来检测必要的C++14编译器支持。

应用示例

例如，QComboBox类的存在如下信号：

[signal] void QComboBox::currentIndexChanged(int index)

当ComboBox的当前索引currentIndex发生变化时，该信号就会被发出。参数index可以传递当前索引值，并且当ComboBox的项为空或者currentIndex被重置时，参数index为-1。

该信号在该类中被重载。要通过函数指针的语法连接该信号，就可以借助qOverload类获取函数指针，这也是Qt官方文档推荐的连接方式：

connect(comboBox, QOverload<int>::of(&QComboBox::currentIndexChanged),
  [=](int index){ /* ... */ });