UTF32Encoding.Equals(Object) Method

Reference

Definition

Namespace:: System.Text

Assemblies:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assemblies:: netstandard.dll, System.Text.Encoding.Extensions.dll

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: UTF32Encoding.cs

Source:: UTF32Encoding.cs

Source:: UTF32Encoding.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 override bool Equals(System::Object ^ value);

public override bool Equals(object value);

public override bool Equals(object? value);

override this.Equals : obj -> bool

Public Overrides Function Equals (value As Object) As Boolean

Parameters

value: Object

The Object to compare with the current object.

Returns

Boolean

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

Examples

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

*/

using System;
using System.Text;

public class SamplesUTF32Encoding  {

   public static void Main()  {

      // Create different instances of UTF32Encoding.
      UTF32Encoding u32   = new UTF32Encoding();
      UTF32Encoding u32tt = new UTF32Encoding( true, true );
      UTF32Encoding u32tf = new UTF32Encoding( true, false );
      UTF32Encoding u32ft = new UTF32Encoding( false, true );
      UTF32Encoding u32ff = new 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" );
   }

   public static void CompareEncodings( UTF32Encoding a, String name )  {

      // Create different instances of UTF32Encoding using the ctor with three parameters.
      UTF32Encoding u32ttt = new UTF32Encoding( true, true, true );
      UTF32Encoding u32ttf = new UTF32Encoding( true, true, false );
      UTF32Encoding u32tft = new UTF32Encoding( true, false, true );
      UTF32Encoding u32tff = new UTF32Encoding( true, false, false );
      UTF32Encoding u32ftt = new UTF32Encoding( false, true, true );
      UTF32Encoding u32ftf = new UTF32Encoding( false, true, false );
      UTF32Encoding u32fft = new UTF32Encoding( false, false, true );
      UTF32Encoding u32fff = new 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

*/

Imports System.Text

Public Class SamplesUTF32Encoding   

   Public Shared Sub Main()

      ' Create different instances of UTF32Encoding.
      Dim u32 As New UTF32Encoding()
      Dim u32tt As New UTF32Encoding(True, True)
      Dim u32tf As New UTF32Encoding(True, False)
      Dim u32ft As New UTF32Encoding(False, True)
      Dim u32ff As New 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")

   End Sub


   Public Shared Sub CompareEncodings(a As UTF32Encoding, name As String)

      ' Create different instances of UTF32Encoding using the ctor with three parameters.
      Dim u32ttt As New UTF32Encoding(True, True, True)
      Dim u32ttf As New UTF32Encoding(True, True, False)
      Dim u32tft As New UTF32Encoding(True, False, True)
      Dim u32tff As New UTF32Encoding(True, False, False)
      Dim u32ftt As New UTF32Encoding(False, True, True)
      Dim u32ftf As New UTF32Encoding(False, True, False)
      Dim u32fft As New UTF32Encoding(False, False, True)
      Dim u32fff As New 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))

   End Sub

End Class


'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

Remarks

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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Share via