Conversões definidas pelo usuário (C++/CLI)
Esta seção aborda as UDCs (conversões definidas pelo usuário) quando um dos tipos na conversão é uma referência ou instância de um tipo de valor ou tipo de referência.
Conversões implícitas e explícitas
Uma conversão definida pelo usuário pode ser implícita ou explícita. Uma UDC deverá ser implícita se a conversão não resultar em perda de informações. Caso contrário, uma UDC explícita deverá ser definida.
O construtor de uma classe nativa pode ser usado para converter um tipo de referência ou valor em uma classe nativa.
Para obter mais informações sobre conversões, confira Conversões boxing e Conversões padrão.
// mcpp_User_Defined_Conversions.cpp
// compile with: /clr
#include "stdio.h"
ref class R;
class N;
value class V {
static operator V(R^) {
return V();
}
};
ref class R {
public:
static operator N(R^);
static operator V(R^) {
System::Console::WriteLine("in R::operator N");
return V();
}
};
class N {
public:
N(R^) {
printf("in N::N\n");
}
};
R::operator N(R^) {
System::Console::WriteLine("in R::operator N");
return N(nullptr);
}
int main() {
// Direct initialization:
R ^r2;
N n2(r2); // direct initialization, calls constructor
static_cast<N>(r2); // also direct initialization
R ^r3;
// ambiguous V::operator V(R^) and R::operator V(R^)
// static_cast<V>(r3);
}
Saída
in N::N
in N::N
Converter de operadores
Operadores convert-from criam um objeto da classe na qual o operador está definido com base em um objeto de alguma outra classe.
O Padrão do C++ não dá suporte a operadores convert-from; o padrão do C++ usa construtores para essa finalidade. No entanto, ao usar tipos do CLR, o Visual C++ fornece suporte sintático para chamar operadores convert-from.
Para a boa interoperabilidade com outras linguagens compatíveis com o CLS, pode ser interessante encapsular cada construtor unário definido pelo usuário de uma determinada classe com um operador convert-from correspondente.
Operadores convert-from:
Devem ser definidos como funções estáticas.
Podem ser implícitos (para conversões que não perdem precisão, como short-to-int) ou explícitos, quando pode haver uma perda de precisão.
Devem retornar um objeto da classe que os contém.
Devem ter o tipo "from" como o único tipo de parâmetro.
O exemplo a seguir mostra um operador UDC (conversão definida pelo usuário) implícito e explícito.
// clr_udc_convert_from.cpp
// compile with: /clr
value struct MyDouble {
double d;
MyDouble(int i) {
d = static_cast<double>(i);
System::Console::WriteLine("in constructor");
}
// Wrap the constructor with a convert-from operator.
// implicit UDC because conversion cannot lose precision
static operator MyDouble (int i) {
System::Console::WriteLine("in operator");
// call the constructor
MyDouble d(i);
return d;
}
// an explicit user-defined conversion operator
static explicit operator signed short int (MyDouble) {
return 1;
}
};
int main() {
int i = 10;
MyDouble md = i;
System::Console::WriteLine(md.d);
// using explicit user-defined conversion operator requires a cast
unsigned short int j = static_cast<unsigned short int>(md);
System::Console::WriteLine(j);
}
Saída
in operator
in constructor
10
1
Operadores convert-to
Os operadores convert-to convertem um objeto da classe na qual o operador está definido para algum outro objeto. O exemplo a seguir mostra um operador de conversão implícito convert-to definido pelo usuário:
// clr_udc_convert_to.cpp
// compile with: /clr
using namespace System;
value struct MyInt {
Int32 i;
// convert MyInt to String^
static operator String^ ( MyInt val ) {
return val.i.ToString();
}
MyInt(int _i) : i(_i) {}
};
int main() {
MyInt mi(10);
String ^s = mi;
Console::WriteLine(s);
}
Saída
10
Um operador de conversão explícito convert-to definido pelo usuário é apropriado para conversões com potencial para perda dados de alguma forma. Para invocar um operador convert-to explícito, uma conversão deve ser usada.
// clr_udc_convert_to_2.cpp
// compile with: /clr
value struct MyDouble {
double d;
// convert MyDouble to Int32
static explicit operator System::Int32 ( MyDouble val ) {
return (int)val.d;
}
};
int main() {
MyDouble d;
d.d = 10.3;
System::Console::WriteLine(d.d);
int i = 0;
i = static_cast<int>(d);
System::Console::WriteLine(i);
}
Saída
10.3
10
Para converter classes genéricas
Você pode converter uma classe genérica em T.
// clr_udc_generics.cpp
// compile with: /clr
generic<class T>
public value struct V {
T mem;
static operator T(V v) {
return v.mem;
}
void f(T t) {
mem = t;
}
};
int main() {
V<int> v;
v.f(42);
int i = v;
i += v;
System::Console::WriteLine(i == (42 * 2) );
}
Saída
True
Um construtor de conversão usa um tipo e o usa para criar um objeto. Um construtor de conversão é chamado apenas com inicialização direta; as conversões não invocarão construtores de conversão. Por padrão, construtores de conversão são explícitos em tipos do CLR.
// clr_udc_converting_constructors.cpp
// compile with: /clr
public ref struct R {
int m;
char c;
R(int i) : m(i) { }
R(char j) : c(j) { }
};
public value struct V {
R^ ptr;
int m;
V(R^ r) : ptr(r) { }
V(int i) : m(i) { }
};
int main() {
R^ r = gcnew R(5);
System::Console::WriteLine( V(5).m);
System::Console::WriteLine( V(r).ptr);
}
Saída
5
R
Neste código de exemplo, uma função de conversão estática implícita faz a mesma coisa que um construtor de conversão explícito.
public value struct V {
int m;
V(int i) : m(i) {}
static operator V(int i) {
V v(i*100);
return v;
}
};
public ref struct R {
int m;
R(int i) : m(i) {}
static operator R^(int i) {
return gcnew R(i*100);
}
};
int main() {
V v(13); // explicit
R^ r = gcnew R(12); // explicit
System::Console::WriteLine(v.m);
System::Console::WriteLine(r->m);
// explicit ctor can't be called here: not ambiguous
v = 5;
r = 20;
System::Console::WriteLine(v.m);
System::Console::WriteLine(r->m);
}
Saída
13
12
500
2000