UTF32Encoding::Equals Method (Object^)

 

Determines whether the specified Object is equal to the current UTF32Encoding object.

Namespace:   System.Text
Assembly:  mscorlib (in mscorlib.dll)

public:
virtual bool Equals(
	Object^ value
) override

Parameters

value
Type: System::Object^

The Object to compare with the current object.

Return Value

Type: System::Boolean

true if value is an instance of UTF32Encoding and is equal to the current object; otherwise, false.

Two UTF32Encoding objects are considered equal if all of the following conditions are true:

  • Both objects use the same byte order.

  • Both objects provide the byte order mark, or both do not.

  • Both objects use the same encoder fallback.

  • Both objects use the same decoder fallback.

The following example creates UTF32Encoding objects using different parameter values and then checks them for equality.

using namespace System;
using namespace System::Text;
void CompareEncodings( UTF32Encoding ^ a, String^ name );
int main()
{

   // Create different instances of UTF32Encoding.
   UTF32Encoding ^ u32 = gcnew UTF32Encoding;
   UTF32Encoding ^ u32tt = gcnew UTF32Encoding( true,true );
   UTF32Encoding ^ u32tf = gcnew UTF32Encoding( true,false );
   UTF32Encoding ^ u32ft = gcnew UTF32Encoding( false,true );
   UTF32Encoding ^ u32ff = gcnew UTF32Encoding( false,false );

   // Compare these instances with instances created using the ctor with three parameters.
   CompareEncodings( u32, "u32  " );
   CompareEncodings( u32tt, "u32tt" );
   CompareEncodings( u32tf, "u32tf" );
   CompareEncodings( u32ft, "u32ft" );
   CompareEncodings( u32ff, "u32ff" );
}

void CompareEncodings( UTF32Encoding ^ a, String^ name )
{

   // Create different instances of UTF32Encoding using the ctor with three parameters.
   UTF32Encoding ^ u32ttt = gcnew UTF32Encoding( true,true,true );
   UTF32Encoding ^ u32ttf = gcnew UTF32Encoding( true,true,false );
   UTF32Encoding ^ u32tft = gcnew UTF32Encoding( true,false,true );
   UTF32Encoding ^ u32tff = gcnew UTF32Encoding( true,false,false );
   UTF32Encoding ^ u32ftt = gcnew UTF32Encoding( false,true,true );
   UTF32Encoding ^ u32ftf = gcnew UTF32Encoding( false,true,false );
   UTF32Encoding ^ u32fft = gcnew UTF32Encoding( false,false,true );
   UTF32Encoding ^ u32fff = gcnew UTF32Encoding( false,false,false );

   // Compare the specified instance with each of the instances that were just created.
   Console::WriteLine( "{0} and u32ttt : {1}", name, a->Equals( u32ttt ) );
   Console::WriteLine( "{0} and u32ttf : {1}", name, a->Equals( u32ttf ) );
   Console::WriteLine( "{0} and u32tft : {1}", name, a->Equals( u32tft ) );
   Console::WriteLine( "{0} and u32tff : {1}", name, a->Equals( u32tff ) );
   Console::WriteLine( "{0} and u32ftt : {1}", name, a->Equals( u32ftt ) );
   Console::WriteLine( "{0} and u32ftf : {1}", name, a->Equals( u32ftf ) );
   Console::WriteLine( "{0} and u32fft : {1}", name, a->Equals( u32fft ) );
   Console::WriteLine( "{0} and u32fff : {1}", name, a->Equals( u32fff ) );
}

/* 
This code produces the following output.

u32   vs u32ttt : False
u32   vs u32ttf : False
u32   vs u32tft : False
u32   vs u32tff : False
u32   vs u32ftt : False
u32   vs u32ftf : False
u32   vs u32fft : False
u32   vs u32fff : True
u32tt vs u32ttt : False
u32tt vs u32ttf : True
u32tt vs u32tft : False
u32tt vs u32tff : False
u32tt vs u32ftt : False
u32tt vs u32ftf : False
u32tt vs u32fft : False
u32tt vs u32fff : False
u32tf vs u32ttt : False
u32tf vs u32ttf : False
u32tf vs u32tft : False
u32tf vs u32tff : True
u32tf vs u32ftt : False
u32tf vs u32ftf : False
u32tf vs u32fft : False
u32tf vs u32fff : False
u32ft vs u32ttt : False
u32ft vs u32ttf : False
u32ft vs u32tft : False
u32ft vs u32tff : False
u32ft vs u32ftt : False
u32ft vs u32ftf : True
u32ft vs u32fft : False
u32ft vs u32fff : False
u32ff vs u32ttt : False
u32ff vs u32ttf : False
u32ff vs u32tft : False
u32ff vs u32tff : False
u32ff vs u32ftt : False
u32ff vs u32ftf : False
u32ff vs u32fft : False
u32ff vs u32fff : True

*/

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top
Show: