【Ruby3.x】IO::Buffer::|()メソッドの使い方

|メソッドは、現在のIO::Bufferオブジェクトが保持するバイト列と、引数として渡される別のIO::Bufferオブジェクトが保持するバイト列に対して、要素ごとにビット論理和演算を実行するメソッドです。このメソッドは、Rubyにおいて|演算子としてオーバーロードされており、2つのIO::Bufferオブジェクト間でビット単位のデータの合成や比較を行う際に利用されます。

具体的には、呼び出し元のIO::Bufferと引数で指定されたIO::Bufferから、対応する位置のバイトを一つずつ取り出し、それぞれのバイト値に対してビット単位で論理和を計算します。ビット論理和は、比較される二つのビットのどちらか一方、または両方が1であれば結果を1とし、両方が0の場合にのみ結果を0とする演算です。この処理の結果は、新たに生成されたIO::Bufferオブジェクトとして返されます。

この操作は、例えば複数のステータスフラグがビット列として格納されているバッファを統合したり、特定のビットパターンを用いてデータを加工したりするような、低レベルなバイナリデータ処理の場面で特に有用です。IO::Bufferはメモリ上の効率的なデータ操作を可能にするため、この|メソッドは、バイナリデータの結合や条件付けを行う上で重要な役割を果たすことがあります。

Copy
1buffer_a = IO::Buffer.new(1)
2buffer_a[0] = 0b00000001 # 最初のバイトに1を設定
3
4buffer_b = IO::Buffer.new(1)
5buffer_b[0] = 0b00000100 # 最初のバイトに4を設定
6
7buffer_result = buffer_a | buffer_b
8# buffer_result の最初のバイトは 0b00000101 (1 OR 4 = 5) となる

引数なし

引数はありません

IO::Buffer

IO::Bufferオブジェクト自身が返されます。