BitArray クラス

リファレンス

定義

名前空間:: System.Collections

アセンブリ:: System.Collections.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

ソース:: BitArray.cs

ソース:: BitArray.cs

ソース:: BitArray.cs

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ビット値の小型の配列を管理します。このビット値はブール型として表され、true はビットがオン (1)、false はビットがオフ (0) であることを示します。

public ref class BitArray sealed : System::Collections::ICollection

public ref class BitArray sealed : ICloneable, System::Collections::ICollection

public sealed class BitArray : System.Collections.ICollection

public sealed class BitArray : ICloneable, System.Collections.ICollection

[System.Serializable]
public sealed class BitArray : ICloneable, System.Collections.ICollection

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class BitArray : ICloneable, System.Collections.ICollection

type BitArray = class
    interface ICollection
    interface IEnumerable

type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type BitArray = class
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public NotInheritable Class BitArray
Implements ICollection

Public NotInheritable Class BitArray
Implements ICloneable, ICollection

継承: Object
BitArray

属性: SerializableAttribute ComVisibleAttribute

実装: ICollection IEnumerable ICloneable

例

次のコード例は、を作成して初期化 BitArray する方法とその値を出力する方法を示しています。

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

注釈

クラスは BitArray 、容量が常にカウントと同じコレクションクラスです。要素は、プロパティを増やすことでにBitArray追加されます。要素は、プロパティをLength小さくすることで削除Lengthされます。の BitArray サイズはクライアントによって制御されます。の末尾 BitArray を越えてインデックスを作成すると、 ArgumentExceptionがスローされます。クラスにはBitArray、フィルター (、など) を使用して一度に複数の要素を変更できるメソッドなどAnd Xor Or Not、他のコレクションにはないメソッドが用意されています。SetAll

クラスは BitVector32 、と同じ機能 BitArrayを提供する構造ですが、パフォーマンスは向上します。 BitVector32 は値型であるため、スタックに割り当てられるため、より高速です。一方 BitArray 、は参照型であるため、ヒープに割り当てられます。

System.Collections.Specialized.BitVector32 は正確に 32 ビットを格納できますが、 BitArray 可変ビット数を格納できます。 BitVector32 はビットフラグと小さな整数の両方を格納するため、ユーザーに公開されていないデータに最適です。ただし、必要なビットフラグの数が不明、変数、または 32 より大きい場合は、代わりにを使用 BitArray します。

BitArrayは名前空間内にありますSystem.Collections。は名前空間にありますSystem.Collections.Specialized。 BitVector32

このコレクション内の要素には、整数インデックスを使用してアクセスできます。このコレクション内のインデックスは 0 から始まります。

コンストラクター

BitArray(BitArray)	指定した BitArray からコピーされたビット値を格納する、BitArray クラスの新しいインスタンスを初期化します。
BitArray(Boolean[])	指定されたブール値配列からコピーされたビット値を含む BitArray クラスの新しいインスタンスを初期化します。
BitArray(Byte[])	指定したバイト配列からビット値をコピーして格納する、BitArray クラスの新しいインスタンスを初期化します。
BitArray(Int32)	指定数のビット値を格納できる、BitArray クラスの新しいインスタンスを初期化します。ビット値は `false` に初期設定されます。
BitArray(Int32, Boolean)	指定数のビット値を格納できる、BitArray クラスの新しいインスタンスを初期化します。ビット値は指定値に初期設定されます。
BitArray(Int32[])	指定した 32 ビット整数配列からビット値をコピーして格納する、BitArray クラスの新しいインスタンスを初期化します。

プロパティ

Count	BitArray に格納されている要素の数を取得します。
IsReadOnly	BitArray が読み取り専用かどうかを示す値を取得します。
IsSynchronized	BitArray へのアクセスが同期されている (スレッドセーフである) かどうかを示す値を取得します。
Item[Int32]	BitArray の特定位置にあるビット値を取得または設定します。
Length	BitArray 内の要素の数を取得または設定します。
SyncRoot	BitArray へのアクセスを同期するために使用できるオブジェクトを取得します。

メソッド

And(BitArray)	現在の BitArray オブジェクトの要素と指定した配列内の対応する要素の間で、ビットごとの AND 演算を実行します。現在の BitArray オブジェクトが変更され、ビットごとの AND 演算の結果を格納します。
Clone()	BitArray の簡易コピーを作成します。
CopyTo(Array, Int32)	BitArray 全体を互換性のある 1 次元の Array にコピーします。コピー操作は、コピー先の配列の指定したインデックスから始まります。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
Get(Int32)	BitArray の特定位置にあるビット値を取得します。
GetEnumerator()	BitArray を反復処理する列挙子を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
HasAllSet()	内 BitArray のすべてのビットがに `true`設定されているかどうかを判断します。
HasAnySet()	内の任意の BitArray ビットがに `true`設定されているかどうかを判断します。
LeftShift(Int32)	現在の BitArray のすべてのビット値を、`count` ビット分、左にシフトします。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
Not()	現在の BitArray にあるすべてのビット値を反転し、`true` に設定されている要素を `false` に、`false` に設定されている要素を `true` に変更します。
Or(BitArray)	現在の BitArray オブジェクトの要素と指定した配列内の対応する要素の間で、ビットごとの OR 演算を実行します。現在の BitArray オブジェクトが変更され、ビットごとの OR 演算の結果を格納します。
RightShift(Int32)	現在の BitArray のすべてのビット値を、`count` ビット分、右にシフトします。
Set(Int32, Boolean)	BitArray の特定位置にあるビットを指定した値に設定します。
SetAll(Boolean)	BitArray 内のすべてのビットを指定した値に設定します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)
Xor(BitArray)	指定した配列内の対応する要素に対して、現在の BitArray の要素間でビットごとの排他的 OR 演算を実行します。現在の BitArray オブジェクトが変更され、ビットごとの排他的 OR 演算の結果を格納します。

明示的なインターフェイスの実装

ICollection.CopyTo(Array, Int32)	指定した BitArray インデックスを開始位置として、Array の要素を Array にコピーします。
ICollection.Count	BitArray にある要素の数を取得します。
ICollection.IsSynchronized	BitArray へのアクセスが同期されるかどうか (スレッドセーフかどうか) を示す値を取得します。
ICollection.SyncRoot	BitArray へのアクセスを同期するために使用できるオブジェクトを取得します。

拡張メソッド

Cast<TResult>(IEnumerable)	IEnumerable の要素を、指定した型にキャストします。
OfType<TResult>(IEnumerable)	指定された型に基づいて IEnumerable の要素をフィルター処理します。
AsParallel(IEnumerable)	クエリの並列化を有効にします。
AsQueryable(IEnumerable)	IEnumerable を IQueryable に変換します。

適用対象

スレッドセーフ

パブリック静的 (Visual Basic ではShared) なこの型のメンバーはスレッドセーフですインスタンスメンバーの場合は、スレッドセーフであるとは限りません。

この実装では、の同期 (スレッドセーフ) ラッパーは BitArray提供されません。

コレクションの列挙処理は、本質的にスレッドセーフな処理ではありません。コレクションが同期されていても、他のスレッドがコレクションを変更する場合があり、このときは列挙子から例外がスローされます。列挙処理を確実にスレッドセーフに行うには、列挙中にコレクションをロックするか、他のスレッドによって行われた変更によってスローされる例外をキャッチします。

こちらもご覧ください

BitVector32

次の方法で共有

BitArray クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

スレッドセーフ

こちらもご覧ください

その他のリソース

次の方法で共有

BitArray クラス

定義

例

注釈

コンストラクター

プロパティ

メソッド

明示的なインターフェイスの実装

拡張メソッド

適用対象

スレッド セーフ

こちらもご覧ください

その他のリソース

スレッドセーフ