BitArray Classe

Definição

Gerencia uma matriz compacta de valores em bits, que é representada com boolianos, em que true indica que o bit está em (1) e false indica que o bit está desativado (0).Manages a compact array of bit values, which are represented as Booleans, where true indicates that the bit is on (1) and false indicates the bit is off (0).

public ref class BitArray sealed : ICloneable, System::Collections::ICollection
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class BitArray : ICloneable, System.Collections.ICollection
type BitArray = class
    interface ICollection
    interface ICloneable
    interface IEnumerable
Public NotInheritable Class BitArray
Implements ICloneable, ICollection
Herança
BitArray
Atributos
Implementações

Exemplos

O exemplo de código a seguir mostra como criar e inicializar um BitArray e como imprimir seus valores.The following code example shows how to create and initialize a BitArray and how to print out its values.

using namespace System;
using namespace System::Collections;
void PrintValues( IEnumerable^ myList, int myWidth );
int main()
{
   
   // Creates and initializes several BitArrays.
   BitArray^ myBA1 = gcnew BitArray( 5 );
   BitArray^ myBA2 = gcnew BitArray( 5,false );
   array<Byte>^myBytes = {1,2,3,4,5};
   BitArray^ myBA3 = gcnew BitArray( myBytes );
   array<Boolean>^myBools = {true,false,true,true,false};
   BitArray^ myBA4 = gcnew BitArray( myBools );
   array<Int32>^myInts = {6,7,8,9,10};
   BitArray^ myBA5 = gcnew BitArray( myInts );
   
   // Displays the properties and values of the BitArrays.
   Console::WriteLine( "myBA1" );
   Console::WriteLine( "   Count:    {0}", myBA1->Count );
   Console::WriteLine( "   Length:   {0}", myBA1->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA1, 8 );
   Console::WriteLine( "myBA2" );
   Console::WriteLine( "   Count:    {0}", myBA2->Count );
   Console::WriteLine( "   Length:   {0}", myBA2->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA2, 8 );
   Console::WriteLine( "myBA3" );
   Console::WriteLine( "   Count:    {0}", myBA3->Count );
   Console::WriteLine( "   Length:   {0}", myBA3->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA3, 8 );
   Console::WriteLine( "myBA4" );
   Console::WriteLine( "   Count:    {0}", myBA4->Count );
   Console::WriteLine( "   Length:   {0}", myBA4->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA4, 8 );
   Console::WriteLine( "myBA5" );
   Console::WriteLine( "   Count:    {0}", myBA5->Count );
   Console::WriteLine( "   Length:   {0}", myBA5->Length );
   Console::WriteLine( "   Values:" );
   PrintValues( myBA5, 8 );
}

void PrintValues( IEnumerable^ myList, int myWidth )
{
   int i = myWidth;
   IEnumerator^ myEnum = myList->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ obj = safe_cast<Object^>(myEnum->Current);
      if ( i <= 0 )
      {
         i = myWidth;
         Console::WriteLine();
      }

      i--;
      Console::Write( "{0,8}", obj );
   }

   Console::WriteLine();
}

/* 
 This code produces the following output.
 
 myBA1
    Count:    5
    Length:   5
    Values:
    False   False   False   False   False
 myBA2
    Count:    5
    Length:   5
    Values:
    False   False   False   False   False
 myBA3
    Count:    40
    Length:   40
    Values:
     True   False   False   False   False   False   False   False
    False    True   False   False   False   False   False   False
     True    True   False   False   False   False   False   False
    False   False    True   False   False   False   False   False
     True   False    True   False   False   False   False   False
 myBA4
    Count:    5
    Length:   5
    Values:
     True   False    True    True   False
 myBA5
    Count:    160
    Length:   160
    Values:
    False    True    True   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
     True    True    True   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
     True   False   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False    True   False    True   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
    False   False   False   False   False   False   False   False
 */
using System;
using System.Collections;
public class SamplesBitArray  {

   public static void Main()  {

      // Creates and initializes several BitArrays.
      BitArray myBA1 = new BitArray( 5 );

      BitArray myBA2 = new BitArray( 5, false );

      byte[] myBytes = new byte[5] { 1, 2, 3, 4, 5 };
      BitArray myBA3 = new BitArray( myBytes );

      bool[] myBools = new bool[5] { true, false, true, true, false };
      BitArray myBA4 = new BitArray( myBools );

      int[]  myInts  = new int[5] { 6, 7, 8, 9, 10 };
      BitArray myBA5 = new BitArray( myInts );

      // Displays the properties and values of the BitArrays.
      Console.WriteLine( "myBA1" );
      Console.WriteLine( "   Count:    {0}", myBA1.Count );
      Console.WriteLine( "   Length:   {0}", myBA1.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA1, 8 );

      Console.WriteLine( "myBA2" );
      Console.WriteLine( "   Count:    {0}", myBA2.Count );
      Console.WriteLine( "   Length:   {0}", myBA2.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA2, 8 );

      Console.WriteLine( "myBA3" );
      Console.WriteLine( "   Count:    {0}", myBA3.Count );
      Console.WriteLine( "   Length:   {0}", myBA3.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA3, 8 );

      Console.WriteLine( "myBA4" );
      Console.WriteLine( "   Count:    {0}", myBA4.Count );
      Console.WriteLine( "   Length:   {0}", myBA4.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA4, 8 );

      Console.WriteLine( "myBA5" );
      Console.WriteLine( "   Count:    {0}", myBA5.Count );
      Console.WriteLine( "   Length:   {0}", myBA5.Length );
      Console.WriteLine( "   Values:" );
      PrintValues( myBA5, 8 );
   }

   public static void PrintValues( IEnumerable myList, int myWidth )  {
      int i = myWidth;
      foreach ( Object obj in myList ) {
         if ( i <= 0 )  {
            i = myWidth;
            Console.WriteLine();
         }
         i--;
         Console.Write( "{0,8}", obj );
      }
      Console.WriteLine();
   }

}


/* 
This code produces the following output.

myBA1
   Count:    5
   Length:   5
   Values:
   False   False   False   False   False
myBA2
   Count:    5
   Length:   5
   Values:
   False   False   False   False   False
myBA3
   Count:    40
   Length:   40
   Values:
    True   False   False   False   False   False   False   False
   False    True   False   False   False   False   False   False
    True    True   False   False   False   False   False   False
   False   False    True   False   False   False   False   False
    True   False    True   False   False   False   False   False
myBA4
   Count:    5
   Length:   5
   Values:
    True   False    True    True   False
myBA5
   Count:    160
   Length:   160
   Values:
   False    True    True   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
    True    True    True   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
    True   False   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False    True   False    True   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
   False   False   False   False   False   False   False   False
*/ 

Imports System.Collections

Public Class SamplesBitArray

    Public Shared Sub Main()

        ' Creates and initializes several BitArrays.
        Dim myBA1 As New BitArray(5)

        Dim myBA2 As New BitArray(5, False)

        Dim myBytes() As Byte = {1, 2, 3, 4, 5}
        Dim myBA3 As New BitArray(myBytes)

        Dim myBools() As Boolean = {True, False, True, True, False}
        Dim myBA4 As New BitArray(myBools)

        Dim myInts() As Integer = {6, 7, 8, 9, 10}
        Dim myBA5 As New BitArray(myInts)

        ' Displays the properties and values of the BitArrays.
        Console.WriteLine("myBA1")
        Console.WriteLine("   Count:    {0}", myBA1.Count)
        Console.WriteLine("   Length:   {0}", myBA1.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA1, 8)

        Console.WriteLine("myBA2")
        Console.WriteLine("   Count:    {0}", myBA2.Count)
        Console.WriteLine("   Length:   {0}", myBA2.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA2, 8)

        Console.WriteLine("myBA3")
        Console.WriteLine("   Count:    {0}", myBA3.Count)
        Console.WriteLine("   Length:   {0}", myBA3.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA3, 8)

        Console.WriteLine("myBA4")
        Console.WriteLine("   Count:    {0}", myBA4.Count)
        Console.WriteLine("   Length:   {0}", myBA4.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA4, 8)

        Console.WriteLine("myBA5")
        Console.WriteLine("   Count:    {0}", myBA5.Count)
        Console.WriteLine("   Length:   {0}", myBA5.Length)
        Console.WriteLine("   Values:")
        PrintValues(myBA5, 8)

    End Sub

    Public Shared Sub PrintValues(myList As IEnumerable, myWidth As Integer)
        Dim i As Integer = myWidth
        Dim obj As [Object]
        For Each obj In  myList
            If i <= 0 Then
                i = myWidth
                Console.WriteLine()
            End If
            i -= 1
            Console.Write("{0,8}", obj)
        Next obj
        Console.WriteLine()
    End Sub

End Class


' This code produces the following output.
' 
' myBA1
'    Count:    5
'    Length:   5
'    Values:
'    False   False   False   False   False
' myBA2
'    Count:    5
'    Length:   5
'    Values:
'    False   False   False   False   False
' myBA3
'    Count:    40
'    Length:   40
'    Values:
'     True   False   False   False   False   False   False   False
'    False    True   False   False   False   False   False   False
'     True    True   False   False   False   False   False   False
'    False   False    True   False   False   False   False   False
'     True   False    True   False   False   False   False   False
' myBA4
'    Count:    5
'    Length:   5
'    Values:
'     True   False    True    True   False
' myBA5
'    Count:    160
'    Length:   160
'    Values:
'    False    True    True   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'     True    True    True   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'     True   False   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False    True   False    True   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False
'    False   False   False   False   False   False   False   False

Comentários

A classe BitArray é uma classe de coleção na qual a capacidade é sempre igual à contagem.The BitArray class is a collection class in which the capacity is always the same as the count. Elementos são adicionados a um BitArray aumentando a propriedade Length; os elementos são excluídos diminuindo a propriedade Length.Elements are added to a BitArray by increasing the Length property; elements are deleted by decreasing the Length property. O tamanho de um BitArray é controlado pelo cliente; a indexação após o final do BitArray gera um ArgumentException. A classe BitArray fornece métodos que não são encontrados em outras coleções, incluindo aqueles que permitem que vários elementos sejam modificados ao mesmo tempo usando um filtro, como And, Or, Xor, Not e SetAll.The size of a BitArray is controlled by the client; indexing past the end of the BitArray throws an ArgumentException.The BitArray class provides methods that are not found in other collections, including those that allow multiple elements to be modified at once using a filter, such as And, Or, Xor , Not, and SetAll.

A classe BitVector32 é uma estrutura que fornece a mesma funcionalidade que BitArray, mas com um desempenho mais rápido.The BitVector32 class is a structure that provides the same functionality as BitArray, but with faster performance. BitVector32 é mais rápido porque é um tipo de valor e, portanto, alocado na pilha, enquanto BitArray é um tipo de referência e, portanto, alocado no heap.BitVector32 is faster because it is a value type and therefore allocated on the stack, whereas BitArray is a reference type and, therefore, allocated on the heap.

System.Collections.Specialized.BitVector32 pode armazenar exatamente 32 bits, enquanto BitArray pode armazenar um número variável de bits.System.Collections.Specialized.BitVector32 can store exactly 32 bits, whereas BitArray can store a variable number of bits. BitVector32 armazena os sinalizadores de bit e os inteiros pequenos, tornando-o ideal para os dados que não são expostos ao usuário.BitVector32 stores both bit flags and small integers, thereby making it ideal for data that is not exposed to the user. No entanto, se o número de sinalizadores de bit necessários for desconhecido, for variável ou for maior que 32, use BitArray em vez disso.However, if the number of required bit flags is unknown, is variable, or is greater than 32, use BitArray instead.

BitArray está no namespace System.Collections; BitVector32 está no namespace System.Collections.Specialized.BitArray is in the System.Collections namespace; BitVector32 is in the System.Collections.Specialized namespace.

Elementos nesta coleção podem ser acessados usando um índice de número inteiro.Elements in this collection can be accessed using an integer index. Os índices nesta coleção são baseados em zero.Indexes in this collection are zero-based.

Construtores

BitArray(BitArray)

Inicializa uma nova instância da classe BitArray que contém valores de bit copiados do BitArray especificado.Initializes a new instance of the BitArray class that contains bit values copied from the specified BitArray.

BitArray(Boolean[])

Inicializa uma nova instância da classe BitArray que contém valores de bit copiados da matriz de boolianos especificada.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of Booleans.

BitArray(Byte[])

Inicializa uma nova instância da classe BitArray que contém valores de bit copiados da matriz de bytes especificada.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of bytes.

BitArray(Int32)

Inicializa uma nova instância da classe BitArray que pode conter o número especificado de valores de bits, que são definidos inicialmente como false.Initializes a new instance of the BitArray class that can hold the specified number of bit values, which are initially set to false.

BitArray(Int32, Boolean)

Inicializa uma nova instância da classe BitArray que pode conter o número especificado de valores de bits, que são definidos inicialmente com o valor especificado.Initializes a new instance of the BitArray class that can hold the specified number of bit values, which are initially set to the specified value.

BitArray(Int32[])

Inicializa uma nova instância da classe BitArray que contém valores de bit copiados da matriz especificada de inteiros de 32 bits.Initializes a new instance of the BitArray class that contains bit values copied from the specified array of 32-bit integers.

Propriedades

Count

Obtém o número de elementos contidos no BitArray.Gets the number of elements contained in the BitArray.

IsReadOnly

Obtém um valor que indica se o BitArray é somente leitura.Gets a value indicating whether the BitArray is read-only.

IsSynchronized

Obtém um valor que indica se o acesso à BitArray é sincronizado (thread-safe).Gets a value indicating whether access to the BitArray is synchronized (thread safe).

Item[Int32]

Obtém ou define o valor do bit em uma posição específica no BitArray.Gets or sets the value of the bit at a specific position in the BitArray.

Length

Obtém ou define o número de elementos no BitArray.Gets or sets the number of elements in the BitArray.

SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao BitArray.Gets an object that can be used to synchronize access to the BitArray.

Métodos

And(BitArray)

Executa a operação AND bit a bit entre os elementos do objeto BitArray atual e os elementos correspondentes na matriz especificada.Performs the bitwise AND operation between the elements of the current BitArray object and the corresponding elements in the specified array. O objeto BitArray atual será modificado para armazenar o resultado da operação AND bit a bit.The current BitArray object will be modified to store the result of the bitwise AND operation.

Clone()

Cria uma cópia superficial do BitArray.Creates a shallow copy of the BitArray.

CopyTo(Array, Int32)

Copia todo o BitArray em um Array unidimensional compatível, começando no índice especificado da matriz de destino.Copies the entire BitArray to a compatible one-dimensional Array, starting at the specified index of the target array.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
Get(Int32)

Obtém o valor do bit em uma posição específica no BitArray.Gets the value of the bit at a specific position in the BitArray.

GetEnumerator()

Retorna um enumerador que itera por meio de BitArray.Returns an enumerator that iterates through the BitArray.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
LeftShift(Int32)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
Not()

Inverte todos os valores de bit no BitArray atual, para que os elementos definidos como true sejam alterados para false e os elementos definidos como false sejam alterados para true.Inverts all the bit values in the current BitArray, so that elements set to true are changed to false, and elements set to false are changed to true.

Or(BitArray)

Executa a operação OR bit a bit entre os elementos do objeto BitArray atual e os elementos correspondentes na matriz especificada.Performs the bitwise OR operation between the elements of the current BitArray object and the corresponding elements in the specified array. O objeto BitArray atual será modificado para armazenar o resultado da operação OR bit a bit.The current BitArray object will be modified to store the result of the bitwise OR operation.

RightShift(Int32)
Set(Int32, Boolean)

Obtém o bit em uma posição específica no BitArray para o valor especificado.Sets the bit at a specific position in the BitArray to the specified value.

SetAll(Boolean)

Define todos os bits no BitArray como o valor especificado.Sets all bits in the BitArray to the specified value.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
Xor(BitArray)

Executa a operação OR exclusiva bit a bit entre os elementos do objeto BitArray atual em relação aos elementos correspondentes na matriz especificada.Performs the bitwise exclusive OR operation between the elements of the current BitArray object against the corresponding elements in the specified array. O objeto BitArray atual será modificado para armazenar o resultado da operação OR exclusiva bit a bit.The current BitArray object will be modified to store the result of the bitwise exclusive OR operation.

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)

Copia os elementos do BitArray para um Array, começando em no índice Array especificado.Copies the elements of the BitArray to an Array, starting at the specified Array index.

ICollection.Count

Obtém o número de elementos no BitArray.Gets the number of elements in the BitArray.

ICollection.IsSynchronized

Obtém um valor que indica se o acesso ao BitArray é sincronizado (thread-safe).Gets a value that indicates whether access to the BitArray is synchronized (thread safe).

ICollection.SyncRoot

Obtém um objeto que pode ser usado para sincronizar o acesso ao BitArray.Gets an object that can be used to synchronize access to the BitArray.

Métodos de Extensão

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Aplica-se a

Acesso thread-safe

Os membros estáticos públicos (Shared no Visual Basic) desse são thread-safe.Public static (Shared in Visual Basic) members of this type are thread safe. Não há garantia de que qualquer membro de instância seja thread-safe.Any instance members are not guaranteed to be thread safe.

Essa implementação não fornece um wrapper sincronizado (thread-safe) para um BitArray.This implementation does not provide a synchronized (thread safe) wrapper for a BitArray.

A enumeração por meio de uma coleção não é um procedimento thread-safe intrínseco.Enumerating through a collection is intrinsically not a thread-safe procedure. Mesmo quando uma coleção está sincronizada, outros threads ainda podem modificar a coleção, o que faz o enumerador lançar uma exceção.Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. Para garantir thread-safe durante a enumeração, é possível bloquear a coleção durante toda a enumeração ou verificar as exceções resultantes das alterações feitas por outros threads.To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

Veja também