ICondition.AwaitNanos(Int64) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在のスレッドがシグナル化または中断されるか、指定された待機時間が経過するまで待機します。
[Android.Runtime.Register("awaitNanos", "(J)J", "GetAwaitNanos_JHandler:Java.Util.Concurrent.Locks.IConditionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public long AwaitNanos (long nanosTimeout);
[<Android.Runtime.Register("awaitNanos", "(J)J", "GetAwaitNanos_JHandler:Java.Util.Concurrent.Locks.IConditionInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member AwaitNanos : int64 -> int64
パラメーター
- nanosTimeout
- Int64
待機する最大時間 (ナノ秒単位)
戻り値
このメソッドからの戻り nanosTimeout
時に待機に費やされた時間を差し引いた値の推定値。
このメソッドの後続の呼び出しの引数として正の値を使用して、目的の時刻の待機を完了できます。 0 以下の値は、時間が残っていないことを示します。
- 属性
例外
現在のスレッドが中断された場合 (およびスレッド中断の中断がサポートされている)
注釈
現在のスレッドがシグナル化または中断されるか、指定された待機時間が経過するまで待機します。
この条件に関連付けられているロックはアトミックに解放され、現在のスレッドはスレッド スケジューリングの目的で無効になり、5 つの><ことが発生するまで><休止状態になります。<ul><li>他のスレッドがこのメソッドCondition
を呼び出#signal
し、現在のスレッドが起動するスレッドとして選択されます。または <li>他のスレッドがこの><Condition
のメソッドを呼び出#signalAll
す場合があります。他のいくつかのスレッド Thread#interrupt は現在のスレッドを中断し、スレッド中断の中断がサポートされています。または <li>指定された待機時間が経過するか、li <>A "<em>偽のウェイクアップ</em>" が発生します。 </ul>
いずれの場合も、このメソッドが返される前に、現在のスレッドがこの条件に関連付けられているロックを再取得する必要があります。 スレッドから戻るときに、<>このロックを保持することが em 保証</em> になります。
現在のスレッド: <ul><li>がこのメソッドへのエントリ時に割り込み状態を設定している場合、または <li>が待機中に Thread#interrupt が中断され、スレッド中断の中断がサポートされている場合、/ul> がInterruptedException
スローされ、<現在のスレッドの中断状態がクリアされます。 ロックが解除される前に中断のテストが発生するかどうかは、最初のケースでは指定されていません。
メソッドは、戻り時に指定された nanosTimeout
値を指定すると待機する残りのナノ秒数の推定値を返します。タイムアウトした場合は 0 以下の値を返します。この値を使用すると、待機が返されるが待機中の条件がまだ保持されない場合に、再待機の有無と待機時間を判断できます。 このメソッドの一般的な使用方法は次のとおりです。
{@code
boolean aMethod(long timeout, TimeUnit unit)
throws InterruptedException {
long nanosRemaining = unit.toNanos(timeout);
lock.lock();
try {
while (!conditionBeingWaitedFor()) {
if (nanosRemaining <= 0L)
return false;
nanosRemaining = theCondition.awaitNanos(nanosRemaining);
}
// ...
return true;
} finally {
lock.unlock();
}
}}
設計上の注意: このメソッドでは、残りの時間を報告する際の切り捨てエラーを回避するために、nanosecond 引数が必要です。 このような精度の低下により、プログラマは、再待機が発生したときに指定されたよりも体系的に待機時間が短くならないようにすることが困難になります。
<b>実装に関する考慮事項</b>
現在のスレッドは、このメソッドが呼び出されたときに、これに Condition
関連付けられているロックを保持するものと見なされます。 これが当てはまるかどうか、そうでない場合は応答方法を決定するのは実装次第です。 通常、例外 (など IllegalMonitorStateException
) がスローされ、実装でその事実を文書化する必要があります。
実装では、シグナルに応答して通常のメソッドの戻り値に対する割り込みへの応答、または指定された待機時間の経過を示すよりも、応答を優先できます。 どちらの場合も、実装では、シグナルが別の待機スレッド (存在する場合) にリダイレクトされるようにする必要があります。
の Java ドキュメント java.util.concurrent.locks.Condition.awaitNanos(long)
。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。