using – deklarace
Deklarace using zavádí název do deklarativní oblast, ve které se deklarace using objeví.
using [typename][::] nested-name-specifier unqualified-id
using :: unqualified-id
Poznámky
Název se stává synonymem pro entitu deklarovanou jinde.Dovoluje použití jednotlivých jmen z určitého oboru názvů bez explicitního kvalifikátoru.To je rozdíl oproti direktivě using, která dovoluje použití všech názvů z oboru názvů bez kvalifikace.Další informace viz Direktiva using.Toto klíčové slovo se také používá pro zástupné typy.
Příklad
Deklaraci using lze použít v definici třídy.
// using_declaration1.cpp
#include <stdio.h>
class B {
public:
void f(char) {
printf_s("In B::f()\n");
}
void g(char) {
printf_s("In B::g()\n");
}
};
class D : B {
public:
using B::f;
using B::g;
void f(int) {
printf_s("In D::f()\n");
f('c');
}
void g(int) {
printf_s("In D::g()\n");
g('c');
}
};
int main() {
D myD;
myD.f(1);
myD.g('a');
}
Při použití k deklaraci člena, musí deklarace using odkazovat na člena základní třídy.
// using_declaration2.cpp
#include <stdio.h>
class B {
public:
void f(char) {
printf_s("In B::f()\n");
}
void g(char) {
printf_s("In B::g()\n");
}
};
class C {
public:
int g();
};
class D2 : public B {
public:
using B::f; // ok: B is a base of D2
// using C::g; // error: C isn't a base of D2
};
int main() {
D2 MyD2;
MyD2.f('a');
}
Členy deklarované pomocí deklarace using lze odkazovat pomocí explicitní kvalifikace.Předpona :: odkazuje na globální obor názvů.
// using_declaration3.cpp
#include <stdio.h>
void f() {
printf_s("In f\n");
}
namespace A {
void g() {
printf_s("In A::g\n");
}
}
namespace X {
using ::f; // global f
using A::g; // A's g
}
void h() {
printf_s("In h\n");
X::f(); // calls ::f
X::g(); // calls A::g
}
int main() {
h();
}
Při vytvoření deklarace using synonyma vytvořená deklarací odkazují pouze na definice, které jsou platné v okamžiku deklarace using.Definice vložené do oboru názvů po deklaraci using nejsou platná synonyma.
Název definovaný pomocí deklarace using je alias pro svůj původní název.To však neovlivní typ, propojení a další atributy původní deklarace.
// post_declaration_namespace_additions.cpp
// compile with: /c
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);
}
Pokud jde o funkce v oborech názvů, pokud je sada místních deklarací a deklarací using pro jeden název uvedena v deklarativním regionu, všechny musí odkazovat na stejnou entitu nebo všechny musí odkazovat na funkce.
// functions_in_namespaces1.cpp
// C2874 expected
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
}
V příkladu výše příkaz using B::i způsobí druhou deklaraci int i ve funkci g().Příkaz using B::f není v konfliktu s funkcí f(char), protože názvy funkcí zavedené B::f mají různé typy parametrů.
Deklarace místní funkce nemůže mít stejný název a typ jako funkce zavedená pomocí deklarace using.Příklad:
// functions_in_namespaces2.cpp
// C2668 expected
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); // C2668 ambiguous: B::f(int) or C::f(int)?
void f(int); // C2883 conflicts with B::f(int) and C::f(int)
}
Z hlediska dědičnosti, pokud deklarace using zavádí název ze základní třídy do oboru odvozené třídy, přepisují členské funkce odvozené třídy virtuální členské funkce se stejným názvem a typy argumentů v základní třídě.
// using_declaration_inheritance1.cpp
#include <stdio.h>
struct B {
virtual void f(int) {
printf_s("In B::f(int)\n");
}
virtual void f(char) {
printf_s("In B::f(char)\n");
}
void g(int) {
printf_s("In B::g\n");
}
void h(int);
};
struct D : B {
using B::f;
void f(int) { // ok: D::f(int) overrides B::f(int)
printf_s("In D::f(int)\n");
}
using B::g;
void g(char) { // ok: there is no B::g(char)
printf_s("In D::g(char)\n");
}
using B::h;
void h(int) {} // Note: D::h(int) hides non-virtual B::h(int)
};
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)
}
int main() {
D * myd = new D();
f(myd);
}
Všechny instance názvu uvedeného v deklaraci using musí být přístupné.Zejména pokud odvozená třída používá deklaraci using k přístupu k členovi základní třídy, musí být název člena přístupný.Pokud je název přetížená členská funkce, pak musí být přístupné všechny vyjmenované funkce.
Viz Řízení přístupu členů, pro další informace o přístupnosti členů.
// using_declaration_inheritance2.cpp
// C2876 expected
class A {
private:
void f(char);
public:
void f(int);
protected:
void g();
};
class B : public A {
using A::f; // C2876: A::f(char) is inaccessible
public:
using A::g; // B::g is a public synonym for A::g
};