楕円および可変値引数テンプレート

ここでは、C++ の可変個引数テンプレートを使用して省略記号 (...) を指定する方法を示します。 省略記号は、C および C++ で多くの用途に使用されてきました。 たとえば、関数の可変個引数リストなどです。 C ランタイム ライブラリの printf() 関数は、最も一般的な例の 1 つです。

可変個引数テンプレートは、任意の数の引数をサポートするクラス テンプレートまたは関数テンプレートです。 この機構はクラス テンプレートと関数テンプレートの両方に適用でき、それによって広範なタイプ セーフと非自明の機能や柔軟性が提供されるため、C++ ライブラリの開発者に特に役立ちます。

構文

可変個引数テンプレートでは、省略記号が 2 とおりの方法で使用されます。 パラメーター名の左側では、省略記号がパラメーター パックを示します。パラメーター名の右側では、パラメーター パックが別個の名前に展開されます。

可変個引数テンプレート クラス定義の構文の基本的な例を次に示します。

template<typename... Arguments> class classname;

パラメーター パックとその展開のいずれの場合でも、次の例に示すように、必要に応じて省略記号の前後に空白を追加できます。

template<typename ...Arguments> class classname;

または:

template<typename ... Arguments> class classname;

この記事では最初の例に示している規約を使用する (省略記号を typename に接続する) ことに注目してください。

前に示した例で、Arguments はパラメーター パックです。 classname クラスには、次の例のように、可変個の引数を指定できます。

template<typename... Arguments> class vtclass;

vtclass< > vtinstance1;
vtclass<int> vtinstance2;
vtclass<float, bool> vtinstance3;
vtclass<long, std::vector<int>, std::string> vtinstance4;

可変個引数テンプレート クラス定義を使用して、1 つ以上のパラメーターを要求することもできます。

template <typename First, typename... Rest> class classname; 

可変個引数テンプレート関数構文の基本的な例を次に示します。

template <typename... Arguments> returntype functionname(Arguments... args);

この後、Arguments パラメーター パックは、次のセクション「可変個引数テンプレートの概要」に示すように、使用のために展開されます。

可変個引数テンプレート関数の構文は、他の形式を使用することもできます。いくつかの例を次に示します。

template <typename... Arguments> returntype functionname(Arguments&... args); 
template <typename... Arguments> returntype functionname(Arguments&&... args);
template <typename... Arguments> returntype functionname(Arguments*... args);

const などの指定子も使用できます。

template <typename... Arguments> returntype functionname(const Arguments&... args); 

可変個引数テンプレート クラス定義を使用して、1 つ以上のパラメーターを要求する関数を作成することができます。

template <typename First, typename... Rest> returntype functionname(const First& first, const Rest&... args); 

可変個引数テンプレートでは、sizeof...() 演算子が使用されます (従来の sizeof() 演算子とは無関係です)。

template<typename... Arguments>
void tfunc(const Arguments&... args)
{
    const unsigned numargs = sizeof...(Arguments);

    X xobj[numargs]; // array of some previously defined type X

    helper_func(xobj, args...);
}

省略記号の配置の詳細

以前にこの記事で、パラメーター パックとその展開を定義する省略記号の配置について、パラメーター名の左に配置すると、パラメーター パックを意味し、パラメーター名の右に配置すると、パラメーター パックの展開を意味する (パラメーター パックが個々の名前に展開される) と説明しました。 これは技術的には事実ですが、コードへの変換の点では混乱することがあります。 次の例を考えてみましょう。

• テンプレートのパラメーター リスト (template <parameter-list>) では、typename... はテンプレート パラメーター パックを定義します。

• パラメーター宣言句 (func(parameter-list)) では、"トップレベル" の省略記号は、関数パラメーター パックを定義し、省略記号の位置は重要です。

  // v1 is NOT a function parameter pack:
  template <typename... Types> void func1(std::vector<Types...> v1); 
  
  // v2 IS a function parameter pack:
  template <typename... Types> void func2(std::vector<Types>... v2); 
  

• 省略記号がパラメーター名の直後にある場合、パラメーター パックの展開を示します。

使用例

可変個引数テンプレート関数の機構について説明するには、これを使用して printf の機能の一部を変更するのが最も適切です。

#include <iostream>

using namespace std;

void print() {
    cout << endl;
}

template <typename T> void print(const T& t) {
    cout << t << endl;
}

template <typename First, typename... Rest> void print(const First& first, const Rest&... rest) {
    cout << first << ", ";
    print(rest...); // recursive call using pack expansion syntax
}

int main()
{
    print(); // calls first overload, outputting only a newline
    print(1); // calls second overload
    
    // these call the third overload, the variadic template, 
    // which uses recursion as needed.
    print(10, 20);
    print(100, 200, 300);
    print("first", 2, "third", 3.14159);
}

出力

1
10, 20
100, 200, 300
first, 2, third, 3.14159

注意

可変個引数テンプレート関数を組み込むほとんどの実装では一種の再帰処理を使用しますが、従来の再帰処理とは少し異なります。従来の再帰処理では、同じシグネチャによって自身を呼び出す関数が使用されます (オーバーロードまたはテンプレート宣言できますが、毎回、同じシグネチャが選択されます)。 可変個引数テンプレートの再帰では、異なる数の引数 (ほとんどの場合、徐々に減少) を使用して可変個引数関数テンプレートを呼び出します。したがって、毎回、異なるシグネチャを押すことになります。"基本ケース" が必要なのは同じですが、再帰の性質は異なります。

参照

関連項目

省略記号 (...)