Como: usar safe_cast no C++/CLI
Este artigo mostra como usar safe_cast em aplicativos C++/CLI. Para obter informações sobre safe_cast no C++/CX, consulte safe_cast.
Upcasting
Um upcast é uma conversão de um tipo derivado para uma de suas classes base. Essa conversão é segura e não requer uma notação de conversão explícita. O exemplo a seguir mostra como executar um upcast, com safe_cast e sem ele.
// safe_upcast.cpp
// compile with: /clr
using namespace System;
interface class A {
void Test();
};
ref struct B : public A {
virtual void Test() {
Console::WriteLine("in B::Test");
}
void Test2() {
Console::WriteLine("in B::Test2");
}
};
ref struct C : public B {
virtual void Test() override {
Console::WriteLine("in C::Test");
};
};
int main() {
C ^ c = gcnew C;
// implicit upcast
B ^ b = c;
b->Test();
b->Test2();
// upcast with safe_cast
b = nullptr;
b = safe_cast<B^>(c);
b->Test();
b->Test2();
}
in C::Test
in B::Test2
in C::Test
in B::Test2
Downcasting
Um downcast é uma conversão de uma classe base para uma classe derivada da classe base. Um downcast só será seguro se o objeto endereçado no runtime estiver realmente abordando um objeto de classe derivada. Ao contrário de static_cast, safe_cast executa uma verificação dinâmica e gera InvalidCastException se houver falhas na conversão.
// safe_downcast.cpp
// compile with: /clr
using namespace System;
interface class A { void Test(); };
ref struct B : public A {
virtual void Test() {
Console::WriteLine("in B::Test()");
}
void Test2() {
Console::WriteLine("in B::Test2()");
}
};
ref struct C : public B {
virtual void Test() override {
Console::WriteLine("in C::Test()");
}
};
interface class I {};
value struct V : public I {};
int main() {
A^ a = gcnew C();
a->Test();
B^ b = safe_cast<B^>(a);
b->Test();
b->Test2();
V v;
I^ i = v; // i boxes V
V^ refv = safe_cast<V^>(i);
Object^ o = gcnew B;
A^ a2= safe_cast<A^>(o);
}
in C::Test()
in C::Test()
in B::Test2()
Correspondência com conversões definidas pelo usuário
O exemplo a seguir mostra como você pode usar safe_cast para invocar conversões definidas pelo usuário.
// safe_cast_udc.cpp
// compile with: /clr
using namespace System;
value struct V;
ref struct R {
int x;
R() {
x = 1;
}
R(int argx) {
x = argx;
}
static operator R::V^(R^ r);
};
value struct V {
int x;
static operator R^(V& v) {
Console::WriteLine("in operator R^(V& v)");
R^ r = gcnew R();
r->x = v.x;
return r;
}
V(int argx) {
x = argx;
}
};
R::operator V^(R^ r) {
Console::WriteLine("in operator V^(R^ r)");
return gcnew V(r->x);
}
int main() {
bool fReturnVal = false;
V v(2);
R^ r = safe_cast<R^>(v); // should invoke UDC
V^ v2 = safe_cast<V^>(r); // should invoke UDC
}
in operator R^(V& v
in operator V^(R^ r)
operações de safe_cast e conversão boxing
Conversão boxing
A conversão boxing é definida como uma conversão definida pelo usuário e injetada pelo compilador. Portanto, você pode usar safe_cast para converter em box um valor no heap da CLR.
O exemplo a seguir mostra a conversão boxing com tipos de valor simples e definidos pelo usuário. Um safe_cast converte em box uma variável de tipo de valor que está na pilha nativa para que ele possa ser atribuído a uma variável no heap coletado pelo lixo.
// safe_cast_boxing.cpp
// compile with: /clr
using namespace System;
interface struct I {};
value struct V : public I {
int m_x;
V(int i) : m_x(i) {}
};
int main() {
// box a value type
V v(100);
I^ i = safe_cast<I^>(v);
int x = 100;
V^ refv = safe_cast<V^>(v);
int^ refi = safe_cast<int^>(x);
}
O exemplo a seguir mostra que a conversão boxing tem prioridade sobre uma conversão definida pelo usuário em uma operação safe_cast.
// safe_cast_boxing_2.cpp
// compile with: /clr
static bool fRetval = true;
interface struct I {};
value struct V : public I {
int x;
V(int argx) {
x = argx;
}
static operator I^(V v) {
fRetval = false;
I^ pi = v;
return pi;
}
};
ref struct R {
R() {}
R(V^ pv) {}
};
int main() {
V v(10);
I^ pv = safe_cast<I^>(v); // boxing will occur, not UDC "operator I^"
}
Conversão unboxing
A conversão unboxing é definida como uma conversão definida pelo usuário e injetada pelo compilador. Portanto, você pode usar safe_cast para em converter em unboxing um valor no heap da CLR.
A conversão unboxing é uma conversão definida pelo usuário, mas ao contrário da conversão boxing, a conversão unboxing deve ser explícita, ou seja, ela deve ser executada por uma static_cast, conversão de estilo C, ou safe_cast; não é possível executar unboxing implicitamente.
// safe_cast_unboxing.cpp
// compile with: /clr
int main() {
System::Object ^ o = 42;
int x = safe_cast<int>(o);
}
O exemplo a seguir mostra a conversão unboxing com tipos de valor e tipos primitivos.
// safe_cast_unboxing_2.cpp
// compile with: /clr
using namespace System;
interface struct I {};
value struct VI : public I {};
void test1() {
Object^ o = 5;
int x = safe_cast<Int32>(o);
}
value struct V {
int x;
String^ s;
};
void test2() {
V localv;
Object^ o = localv;
V unboxv = safe_cast<V>(o);
}
void test3() {
V localv;
V^ o2 = localv;
V unboxv2 = safe_cast<V>(o2);
}
void test4() {
I^ refi = VI();
VI vi = safe_cast<VI>(refi);
}
int main() {
test1();
test2();
test3();
test4();
}
safe_cast e tipos genéricos
O exemplo a seguir mostra como você pode usar safe_cast para executar um downcast com um tipo genérico.
// safe_cast_generic_types.cpp
// compile with: /clr
interface struct I {};
generic<class T> where T:I
ref struct Base {
T t;
void test1() {}
};
generic<class T> where T:I
ref struct Derived:public Base <T> {};
ref struct R:public I {};
typedef Base<R^> GBase_R;
typedef Derived<R^> GDerived_R;
int main() {
GBase_R^ br = gcnew GDerived_R();
GDerived_R^ dr = safe_cast<GDerived_R^>(br);
}