using Declaration

The using declaration introduces a name into the declarative region in which the using declaration appears. The name becomes a synonym for an entity declared elsewhere. It allows an individual name from a specific namespace to be used without explicit qualification. This is in contrast to the using directive, which allows all the names in a namespace to be used without qualification. See using Directive for more information.

Syntax

using-declaration :

using ::opt nested-name-specifier unqualified-id
using :: unqualified-id

A using-declaration can be used in a class definition. For example:

class B
{
    void f(char);
    void g(char);
};

class D : B
{
    using B::f;
    void f(int) { f('c'); }        // calls B::f(char)
    void g(int) { g('c'); }        // recursively calls D::g(int)
                                   // only B::f is being used
};

When used to declare a member, a using-declaration must refer to a member of a base class. For example:

class C
{
    int g();
};

class D2 : public B
{
    using B::f;          // ok: B is a base of D2
    using C::g;          // error: C isn't a base of D2
};

Members declared with a using-declaration can be referenced using explicit qualification. The :: prefix refers to the global namespace. For example:

void f();

namespace A
{
    void g();
}

namespace X
{
    using ::f;        // global f
    using A::g;       // A's g
}

void h()
{
    X::f();           // calls ::f
    X::g();           // calls A::g
}

Just as with any declaration, a using-declaration can be used repeatedly only where multiple declarations are allowed. For example:

namespace A
{
    int i;
}

void f()
{
    using A::i;
    using A::i;        // ok: double declaration
}

class B
{
protected:
    int i;
};

class X : public B
{
public:
    using B::i;
    using B::i;        // error: class members cannot be multiply declared
};

When a using-declaration is made, the synonym created by the declaration refers only to definitions that are valid at the point of the using-declaration. Definitions added to a namespace after the using-declaration are not valid synonyms. For example:

namespace A
{
    void f(int);
}

using A::f;        // f is a synonym for A::f(int) only

namespace A
{
    void f(char);
}

void f()
{
    f('a');            // refers to A::f(int), even though A::f(char) exists
}

void b()
{
    using A::f;        // refers to A::f(int) AND A::f(char)
    f('a');            // calls A::f(char);
}

A name defined by a using-declaration is an alias for its original name. It does not affect the type, linkage or other attributes of the original declaration.

If a set of local declarations and using-declarations for a single name are given in a declarative region, they must all refer to the same entity, or they must all refer to functions. For example:

namespace B
{
    int i;
    void f(int);
    void f(double);
}

void g()
{
    int i;
    using B::i;          // error: i declared twice
    void f(char);
    using B::f;          // ok: each f is a function
}

In the example above, the using B::i statement causes a second int i to be declared in the g() function. The using B::f statement does not conflict with the f(char) function because the function names introduced by B::f have different parameter types.

A local function declaration cannot have the same name and type as a function introduced by a using-declaration. For example:

namespace B
{
    void f(int);
    void f(double);
}

namespace C
{
    void f(int);
    void f(double);
    void f(char);
}

void h()
{
    using B::f;          // introduces B::f(int) and B::f(double)
    using C::f;          // C::f(int), C::f(double), and C::f(char)
    f('h');              // calls C::f(char)
    f(1);                // error: ambiguous: B::f(int) or C::f(int)?
    void f(int);         // error: conflicts with B::f(int) and C::f(int)
}

When a using-declaration introduces a name from a base class into a derived class scope, member functions in the derived class override virtual member functions with the same name and argument types in the base class. For example:

struct B
{
    virtual void f(int);
    virtual void f(char);
    void g(int);
    void h(int);
};

struct D : B
{
     using B::f;
    void f(int);         // ok: D::f(int) overrides B::f(int)

    using B::g;
    void g(char);        // ok: there is no B::g(char)

    using B::h;
    void h(int);         // error: D::h(int) conflicts with B::h(int)
                         // B::h(int) is not virtual
};

void f(D* pd)
{
    pd->f(1);            // calls D::f(int)
    pd->f('a');          // calls B::f(char)
    pd->g(1);            // calls B::g(int)
    pd->g('a');          // calls D::g(char)
}

All instances of a name mentioned in a using-declaration must be accessible. In particular, if a derived class uses a using-declaration to access a member of a base class, the member name must be accessible. If the name is that of an overloaded member function, then all functions named must be accessible. For example:

class A
{
private:
    void f(char);
public:
    void f(int);
protected:
    void g();
};

class B : public A
{
    using A::f;          // error: A::f(char) is inaccessible
public:
    using A::g;          // B::g is a public synonym for A::g
};

See Chapter 10, Member-Access Control for more information on accessibility of members.