instance method IO::Buffer#locked

ブロックを実行する間、バッファをロックします。ブロックの値を返します。

ロックされている間、そのバッファに対して IO::Buffer#resize や IO::Buffer#free、さらに IO::Buffer#locked を呼ぶと IO::Buffer::LockedError が発生します。バッファへの読み書き自体はロック中も行えます。

システムコールでバッファを使っている間に、そのバッファが移動したり解放されたりしないことを保証するための仕組みです。スレッド安全ではないため、複数のスレッドでバッファを共有する場合は別に同期の手段が必要です。

ブロックの実行中に例外が発生した場合、4.0.6 以降ではロックが解除されます。 4.0.5 以前では解除されずに残ります。

[EXCEPTION] LocalJumpError:

ブロックを渡さなかった場合に発生します。

[EXCEPTION] IO::Buffer::LockedError:

すでにロックされているバッファに対して呼び出した場合に発生します。

buf = IO::Buffer.new(4)

p buf.locked?                # => false
p buf.locked { buf.locked? } # => true
p buf.locked?                # => false

# ブロックの値がそのまま返る
p buf.locked { "done" }      # => "done"

buf = IO::Buffer.new(4)
buf.locked { buf.resize(8) } # ~> IO::Buffer::LockedError

[SEE_ALSO] IO::Buffer#locked?, IO::Buffer::LOCKED