BitVector32::Equals Method (Object^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Determines whether the specified object is equal to the BitVector32.

Namespace:   System.Collections.Specialized
Assembly:  System (in System.dll)

public:
virtual bool Equals(
	Object^ o
) override

Parameters

o
Type: System::Object^

The object to compare with the current BitVector32.

Return Value

Type: System::Boolean

true if the specified object is equal to the BitVector32; otherwise, false.

The object o is considered equal to the BitVector32 if the type of o is compatible with the BitVector32 type and if the value of o is equal to the value of Data.

This method is an O(1) operation.

The following code example compares a BitVector32 with another BitVector32 and with an Int32.

#using <system.dll>

using namespace System;
using namespace System::Collections::Specialized;

int main()
{
   // Creates and initializes a BitVector32 with the value 123.
   // This is the BitVector32 that will be compared to different types.
   BitVector32 myBV(123);

   // Creates and initializes a new BitVector32 which will be set up as sections.
   BitVector32 myBVsect(0);

   // Compares myBV and myBVsect.
   Console::WriteLine( "myBV                 : {0}", myBV );
   Console::WriteLine( "myBVsect             : {0}", myBVsect );
   if ( myBV.Equals( myBVsect ) )
      Console::WriteLine( "   myBV( {0}) equals myBVsect( {1}).", myBV.Data, myBVsect.Data );
   else
      Console::WriteLine( "   myBV( {0}) does not equal myBVsect( {1}).", myBV.Data, myBVsect.Data );

   Console::WriteLine();

   // Assigns values to the sections of myBVsect.
   BitVector32::Section mySect1 = BitVector32::CreateSection( 5 );
   BitVector32::Section mySect2 = BitVector32::CreateSection( 1, mySect1 );
   BitVector32::Section mySect3 = BitVector32::CreateSection( 20, mySect2 );
   myBVsect[ mySect1 ] = 3;
   myBVsect[ mySect2 ] = 1;
   myBVsect[ mySect3 ] = 7;

   // Compares myBV and myBVsect.
   Console::WriteLine( "myBV                 : {0}", myBV );
   Console::WriteLine( "myBVsect with values : {0}", myBVsect );
   if ( myBV.Equals( myBVsect ) )
      Console::WriteLine( "   myBV( {0}) equals myBVsect( {1}).", myBV.Data, myBVsect.Data );
   else
      Console::WriteLine( "   myBV( {0}) does not equal myBVsect( {1}).", myBV.Data, myBVsect.Data );

   Console::WriteLine();

   // Compare myBV with an Int32.
   Console::WriteLine( "Comparing myBV with an Int32: " );
   Int32 myInt32 = 123;

   // Using Equals will fail because Int32 is not compatible with BitVector32.
   if ( myBV.Equals( myInt32 ) )
      Console::WriteLine( "   Using BitVector32::Equals, myBV( {0}) equals myInt32( {1}).", myBV.Data, myInt32 );
   else
      Console::WriteLine( "   Using BitVector32::Equals, myBV( {0}) does not equal myInt32( {1}).", myBV.Data, myInt32 );

   // To compare a BitVector32 with an Int32, use the "==" operator.
   if ( myBV.Data == myInt32 )
      Console::WriteLine( "   Using the \"==\" operator, myBV.Data( {0}) equals myInt32( {1}).", myBV.Data, myInt32 );
   else
      Console::WriteLine( "   Using the \"==\" operator, myBV.Data( {0}) does not equal myInt32( {1}).", myBV.Data, myInt32 );
}

/*
This code produces the following output.

myBV                 : BitVector32 {00000000000000000000000001111011}
myBVsect             : BitVector32 {00000000000000000000000000000000}
   myBV(123) does not equal myBVsect(0).

myBV                 : BitVector32 {00000000000000000000000001111011}
myBVsect with values : BitVector32 {00000000000000000000000001111011}
   myBV(123) equals myBVsect(123).

Comparing myBV with an Int32:
   Using BitVector32::Equals, myBV(123) does not equal myInt32(123).
   Using the "==" operator, myBV.Data(123) equals myInt32(123).

*/

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