命名空间
变体
操作

注入类名

来自 cppreference.com
< cpp‎ | 语言
 
 
C++ 语言
 
 

注入类名是类在该类作用域内的非限定名称。

类模板 中,注入类名可以作为引用当前模板的模板名称使用,也可以作为引用当前实例化的类名称使用。

内容

[编辑] 解释

类作用域 中,当前类或当前类模板的类名被视为一个公共成员名;这被称为注入类名。该名称的声明点紧随类(模板)定义的左花括号。

int X;
 
struct X
{
    void f()
    {
        X* p;   // OK, X is an injected-class-name
        ::X* q; // Error: name lookup finds a variable name, which hides the struct name
    }
};
 
template<class T>
struct Y
{
    void g()
    {
        Y* p;    // OK, Y is an injected-class-name
        Y<T>* q; // OK, Y is an injected-class-name, but Y<T> is not
    }
};

与其他成员一样,注入类名也会被继承。在私有或受保护继承的情况下,间接基类的注入类名最终可能在派生类中不可访问。

struct A {};
struct B : private A {};
struct C : public B
{
    A* p;   // Error: injected-class-name A is inaccessible
    ::A* q; // OK, does not use the injected-class-name
};

[编辑] 在类模板中

类模板的注入类名可以作为模板名或类型名使用。

在以下情况下,注入类名被视为类模板本身的模板名

否则,它被视为类型名,等效于模板名后跟类模板的模板参数,并用 <> 括起来。

template<template<class, class> class>
struct A;
 
template<class T1, class T2>
struct X
{
    X<T1, T2>* p;   // OK, X is treated as a template-name
 
    using a = A<X>; // OK, X is treated as a template-name
 
    template<class U1, class U2>
    friend class X; // OK, X is treated as a template-name
 
    X* q;           // OK, X is treated as a type-name, equivalent to X<T1, T2>
};

在类 模板特化偏特化 的作用域内,当注入类名用作类型名时,它等效于模板名后跟类模板特化或偏特化的模板参数,并用 <> 括起来。

template<>
struct X<void, void>
{
    X* p; // OK, X is treated as a type-name, equivalent to X<void, void>
 
    template<class, class>
    friend class X; // OK, X is treated as a template-name (same as in primary template)
 
    X<void, void>* q; // OK, X is treated as a template-name
};
 
template<class T>
struct X<char, T>
{
    X* p, q; // OK, X is treated as a type-name, equivalent to X<char, T>
 
    using r = X<int, int>; // OK, can be used to name another specialization
};

类模板或类模板特化的注入类名可以在其作用域内的任何地方用作模板名或类型名。

template<>
class X<int, char>
{
    class B
    {
        X a;            // meaning X<int, char>
 
        template<class, class>
        friend class X; // meaning ::X
    };
};
 
template<class T>
struct Base
{
    Base* p; // OK: Base means Base<T>
};
 
template<class T>
struct Derived : public Base<T*>
{
    typename Derived::Base* p; // OK: Derived::Base means Derived<T>::Base,
                               // which is Base<T*>
};
 
template<class T, template<class> class U = T::template Base>
struct Third {};
 
Third<Derived<int>> t; // OK: default argument uses injected-class-name as a template

查找注入类名可能会导致某些情况下的歧义(例如,如果在多个基类中找到它)。如果所有找到的注入类名都引用同一个类模板的特化,并且如果该名称用作模板名,则该引用引用类模板本身而不是其特化,并且不产生歧义。

template<class T>
struct Base {};
 
template<class T>
struct Derived: Base<int>, Base<char>
{
    typename Derived::Base b;         // error: ambiguous
    typename Derived::Base<double> d; // OK
};

[编辑] 注入类名和构造函数

构造函数没有名称,但在构造函数声明和定义中,封闭类的注入类名被认为是构造函数的名称。

在限定名称 C::D 中,如果

  • 名称查找不忽略函数名称,并且
  • 在类 C 的作用域内查找 D 会找到其注入类名

限定名称始终被认为是命名C的构造函数。这样的名称只能在构造函数的声明中使用(例如在友元构造函数声明中、构造函数模板特化中、构造函数模板实例化中或构造函数定义中)或者用于继承构造函数(自 C++11 起)

struct A
{
    A();
    A(int);
 
    template<class T>
    A(T) {}
};
using A_alias = A;
 
A::A() {}
A_alias::A(int) {}
template A::A(double);
 
struct B : A
{
    using A_alias::A;
};
 
A::A a;         // Error: A::A is considered to name a constructor, not a type
struct A::A a2; // OK, same as 'A a2;'
B::A b;         // OK, same as 'A b;'

[编辑] 缺陷报告

以下更改行为的缺陷报告被追溯应用于之前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
CWG 1004 C++98 注入类名称不能
成为模板模板参数
允许,它指的是该类
在这种情况下,模板本身
CWG 2637 C++98 整个模板 ID 可以是注入类名称 只有模板名称可以