ReentrantReadWriteLock.ReentrantWriteLock.TryLock メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| TryLock() |
呼び出し時に別のスレッドによって保持されていない場合にのみ、書き込みロックを取得します。 |
| TryLock(Int64, TimeUnit) |
指定された待機時間内に別のスレッドによって保持されておらず、現在のスレッドが Thread#interrupted になっていない場合に書き込みロックを取得します。 |
TryLock()
呼び出し時に別のスレッドによって保持されていない場合にのみ、書き込みロックを取得します。
[Android.Runtime.Register("tryLock", "()Z", "GetTryLockHandler")]
public virtual bool TryLock ();[<Android.Runtime.Register("tryLock", "()Z", "GetTryLockHandler")>]
abstract member TryLock : unit -> bool
override this.TryLock : unit -> bool戻り値
true ロックが解放され、現在のスレッドによって取得された場合、または書き込みロックが現在のスレッドによって既に保持されている場合。それ以外の false 場合。
実装
- 属性
注釈
呼び出し時に別のスレッドによって保持されていない場合にのみ、書き込みロックを取得します。
読み取りロックも書き込みロックも別のスレッドによって保持されていない場合に書き込みロックを取得し、その値 trueを使用してすぐに戻り、書き込みロックの保留カウントを 1 に設定します。 このロックが公正な順序付けポリシーを使用するように設定されている場合でも、他のスレッドが現在書き込みロックを待機しているかどうかに関係なく、em>の<>呼び出しtryLock()<は、使用可能であればすぐにロックを取得します。 この >barging>の動作は、公平性を破る場合でも、特定の状況で役立ちます。 このロックの公平性の設定を尊重する場合は、ほぼ同等の値を使用 #tryLock(long, TimeUnit) tryLock(0, TimeUnit.SECONDS) します (中断も検出されます)。
現在のスレッドがこのロックを既に保持している場合、保留カウントは 1 ずつインクリメントされ、メソッドは .true
ロックが別のスレッドによって保持されている場合、このメソッドはすぐに値 falseを返します。
の Java ドキュメントjava.util.concurrent.locks.ReentrantReadWriteLock.WriteLock.tryLock()
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
適用対象
TryLock(Int64, TimeUnit)
指定された待機時間内に別のスレッドによって保持されておらず、現在のスレッドが Thread#interrupted になっていない場合に書き込みロックを取得します。
[Android.Runtime.Register("tryLock", "(JLjava/util/concurrent/TimeUnit;)Z", "GetTryLock_JLjava_util_concurrent_TimeUnit_Handler")]
public virtual bool TryLock (long timeout, Java.Util.Concurrent.TimeUnit? unit);[<Android.Runtime.Register("tryLock", "(JLjava/util/concurrent/TimeUnit;)Z", "GetTryLock_JLjava_util_concurrent_TimeUnit_Handler")>]
abstract member TryLock : int64 * Java.Util.Concurrent.TimeUnit -> bool
override this.TryLock : int64 * Java.Util.Concurrent.TimeUnit -> boolパラメーター
- timeout
- Int64
書き込みロックを待機する時間
- unit
- TimeUnit
タイムアウト引数の時間単位
戻り値
true ロックが解放され、現在のスレッドによって取得された場合、または書き込みロックが現在のスレッドによって既に保持されている場合。ロック false を取得する前に待機時間が経過した場合。
実装
- 属性
例外
現在のスレッドが中断された場合
時間単位が null の場合
注釈
指定された待機時間内に別のスレッドによって保持されておらず、現在のスレッドが Thread#interrupted になっていない場合に書き込みロックを取得します。
読み取りロックも書き込みロックも別のスレッドによって保持されていない場合に書き込みロックを取得し、その値 trueを使用してすぐに戻り、書き込みロックの保留カウントを 1 に設定します。 このロックが公正な順序付けポリシーを使用するように設定されている場合、他のスレッドが書き込みロックを待機している場合、使用可能なロック <em>は取得されません</em> 。 これはメソッドとは対照的 #tryLock() です。 フェア ロックのバージを許可する時間 tryLock 指定が必要な場合は、時間指定されたフォームと時間が設定されていないフォームを組み合わせます。
{@code
if (lock.tryLock() ||
lock.tryLock(timeout, unit)) {
...
}}
現在のスレッドがこのロックを既に保持している場合、保留カウントは 1 ずつインクリメントされ、メソッドは .true
ロックが別のスレッドによって保持されている場合、現在のスレッドはスレッド スケジューリングのために無効になり、次の 3 つのいずれかが発生するまで休止状態になります。
<ul>
<li>書き込みロックは現在のスレッドによって取得されます。
<li>他のスレッドスレッド#割り込みによって現在のスレッドが割り込まれます。
<li>指定された待機時間が経過する
</ul>
書き込みロックが取得されると、値 true が返され、書き込みロックの保留カウントが 1 に設定されます。
現在のスレッドの場合:
<ul>
<li>は、このメソッドへのエントリ時に割り込み状態が設定されています。
<li>は、書き込みロックの取得中に Thread#interrupt が中断されました。
</ul>
が InterruptedException スローされ、現在のスレッドの中断状態がクリアされます。
指定した待機時間が経過すると、値 false が返されます。 時間が 0 以下の場合、メソッドはまったく待機しません。
この実装では、このメソッドは明示的な中断ポイントであるため、ロックの通常または再入可能な取得に対する割り込みに応答し、待機時間の経過を報告するよりも優先されます。
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。