• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

    最終更新日時(UTC):
    が更新

    履歴 編集

    変数テンプレート [N3651]

    このページはC++14に採用された言語機能の変更を解説しています。

    のちのC++規格でさらに変更される場合があるため関連項目を参照してください。

    概要

    変数定義時のテンプレート指定を可能にする。

    C++11までは、関数、クラス、型の別名をテンプレートで定義できた。C++14からは、変数もテンプレートで定義できるようになった。これにより、型もしくは整数値をパラメータにとり、そのパラメータの組み合わせごとに変数の値を保持できるようになった。

    これはたとえば、円周率πの値を、数値型ごとの有効桁数で取得するために使用できる:

    template <class T>
    constexpr T pi = static_cast<T>(3.14159265358979323846);
    
    // 円の面積を求める
    template <class T>
    T area_of_circle_with_radius(T r)
    {
      return pi<T> * r * r;
    }
    

    従来であれば、このような目的には、関数テンプレートが使用されていた。型Tの円周率を返す関数pi()を定義すればよかった。しかし、多倍長整数のように、コピーのコストが高いものについては、関数テンプレートよりも、変数テンプレートを使用した方が効率がよくなる。

    そのほかの用途としては、関数呼び出しの丸カッコを省略できるため、2文字ではあるがより短いコードを書けるようにできる、というものもある。たとえば、型Tが整数型か判定するstd::is_integral型特性は、以下のように、::valueを付けるか、クラスのインスタンスを作成してboolへの変換演算子を呼び出す必要がある:

    #include <type_traits>
    
    int main()
    {
      if (std::is_integral<int>::value) {}
      if (std::is_integral<int>()) {}
    }
    

    変数テンプレートを使用することで、以下のように記述できる:

    template <class T>
    constexpr bool is_integral_v = false;
    
    template <>
    constexpr bool is_integral_v<int> = true;
    
    // 以下のようにラッパーとして定義してもよい
    // #include <type_traits>
    // template <class T>
    // constexpr bool is_integral_v = std::is_integral<int>::value;
    
    int main()
    {
      if (is_integral_v<int>) {}
    }
    

    仕様

    C++14より前の規格でも使用できた関数テンプレートを変数にも適用可能に拡張した仕様である。

    言語規格から変数テンプレートについて明記されている仕様を、以下に整理する。

    これらは全て、関数、クラス、型の別名のテンプレートについての定義と同様である。

    • constexprを適用できる。(§7.1.5 The constexpr specifier)
    • 変数の宣言でテンプレートを宣言できる。(§14 Templates)
    • クラススコープにおける変数テンプレートは静的メンバ変数テンプレートとなる。(§14 Templates)
    • 翻訳単位ごとにインスタンス化される。(§14 Templates)
    • 必要に応じて暗黙的にインスタンス化される。(§14.7.1 Implicit instantiation)
    • 明示的なインスタンス化が可能。(§14.7.2 Explicit instantiation)
    • デフォルトテンプレート引数は使用される文脈により暗黙的に使用される。(§14.7.1 Implicit instantiation)
    • テンプレート変数のインスタンス化は名前空間へ行われる。(§14.7.1 Implicit instantiation, §14.7.2 Explicit instantiation)
    • テンプレート変数の宣言は明示的なインスタンス化よりも前に行わなければならない。(§14.7.2 Explicit instantiation)

    #include <iostream>
    #include <iomanip>
    #include <limits>
    
    // ネイピア数: http://www.wolframalpha.com/input/?i=Napier%27s%20constant
    template < typename T = float >
    constexpr auto napier = static_cast<T>( 2.718'281'828'459'045'235'360'287'471'352'662'497'757'247'093'699'959'5L );
    
    template <class FloatingPoint>
    constexpr int precision = std::numeric_limits<FloatingPoint>::max_digits10;
    
    auto main() -> int
    {
      std::cout
        << std::setprecision(precision<float>)       << napier<>            << "\n"
        << std::setprecision(precision<double>)      << napier<double>      << "\n"
        << std::setprecision(precision<long double>) << napier<long double> << "\n"
        << "2.7182818284590452353602874713526624977572470936999595" << std::endl
        ;
    }
    

    出力例

    2.71828175
    2.7182818284590451
    2.71828182845904523543
    2.7182818284590452353602874713526624977572470936999595
    

    この機能が必要になった背景・経緯

    • 型をパラメーター化された定数値を簡単に扱いたい。(N3651)
    • constexprでそのような定数値を扱いたい。(N3651)
    • C++11規格の範囲内でも対応は出来たが煩雑で扱い難い方法を取る必要があるため簡潔に扱えるようにしたい。(N3651)

    検討されたほかの選択肢

    • constまたはconstexprと組み合わせて用いる提案があったが、ワーキンググループの多数意見によりC++14の対象では制限しない事にした。(N3651)
    • テンプレートテンプレートについても提案があったが、ワーキンググループで複数の不要論がありC++14では含めない事にした。(N3651)

    関連項目

    参照