ReentrantLock.TryLock メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| TryLock() |
呼び出し時に別のスレッドによって保持されていない場合にのみ、ロックを取得します。 |
| TryLock(Int64, TimeUnit) |
指定された待機時間内に別のスレッドによって保持されておらず、現在のスレッドが Thread#interrupt が中断されていない場合にロックを取得します。 |
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 に設定します。 このロックが公正な順序付けポリシーを使用するように設定されている場合でも、他のスレッドが現在ロックを待機しているかどうかに関係なく、 tryLock()<em>will</em> を呼び出すとすぐにロックが取得されます。 この >barging>の動作は、公平性を破る場合でも、特定の状況で役立ちます。 このロックの公平性の設定を尊重する場合は、ほぼ同等の #tryLock(long, TimeUnit) tryLock(0, TimeUnit.SECONDS) を使用します (中断も検出します)。
現在のスレッドがこのロックを既に保持している場合、保留カウントは 1 ずつインクリメントされ、メソッドは trueを返します。
ロックが別のスレッドによって保持されている場合、このメソッドはすぐに値 falseで返されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
TryLock(Int64, TimeUnit)
指定された待機時間内に別のスレッドによって保持されておらず、現在のスレッドが Thread#interrupt が中断されていない場合にロックを取得します。
[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#interrupt が中断されていない場合にロックを取得します。
別のスレッドによって保持されていない場合にロックを取得し、 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>is Thread#interrupt interrupt interrupted while acquire the lock,
</ul>InterruptedExceptionがスローされ、現在のスレッドの中断状態がクリアされます。
指定した待機時間が経過すると、 false 値が返されます。 時間が 0 以下の場合、メソッドはまったく待機しません。
この実装では、このメソッドは明示的な中断ポイントであるため、ロックの通常または再入可能な取得に対する割り込みに応答し、待機時間の経過を報告するよりも優先されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。