ICondition.AwaitNanos(Int64) メソッド

[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値の推定値から、このメソッドからの戻りを待機する時間を差し引いた値。 このメソッドの後続の呼び出しの引数として正の値を使用して、目的の時刻の待機を終了できます。 0 以下の値は、時間が残っていないことを示します。

属性

RegisterAttribute

例外

注釈

現在のスレッドが通知または中断されるまで、または指定された待機時間が経過するまで待機します。

この条件に関連付けられているロックはアトミックに解放され、現在のスレッドはスレッド スケジューリングのために無効になり、<em>one</em>が発生するまで休止状態になります。<ul><li>他のスレッドがこのConditionの#signalメソッドを呼び出す場合、現在のスレッドは、スレッドが再開されるときに選択されます。 または <li>他のスレッドがこのConditionに対して#signalAll メソッドを呼び出すか、<li を呼び出します>他のスレッドスレッド#割り込みによって現在のスレッドが中断され、スレッド中断の中断がサポートされています。または <li>指定された待機時間が経過します。または、<li>A > <em>spurious wakeup</em>> が発生します。 </ul>

いずれの場合も、このメソッドが返される前に、現在のスレッドがこの条件に関連付けられているロックを再取得する必要があります。 スレッドが返されるときに、このロックを保持 <em>guaranteed</em> 。

現在のスレッド<ul><li>このメソッドへのエントリ時に割り込まれた状態が設定されている場合、または<>スレッドの中断の待機中に中断されたスレッド#割り込みがサポートされている場合、</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();
              }
            }}

設計上の注意: このメソッドでは、残りの時間を報告する際の切り捨てエラーを回避するために、ナノ秒の引数が必要です。 このような精度の低下により、プログラマは、再待機が発生したときに指定された合計待機時間が体系的に短くならないようにすることが困難になります。

<b>実装に関する考慮事項</b>

現在のスレッドは、このメソッドが呼び出されたときに、この Condition に関連付けられているロックを保持するものと見なされます。 これが当てはまるかどうか、そうでない場合の応答方法を判断するのは実装次第です。 通常、例外 ( IllegalMonitorStateException など) がスローされ、実装はその事実を文書化する必要があります。

実装では、シグナルに応答して通常のメソッドの戻り値に対する割り込みに応答するか、指定された待機時間の経過を示す割り込みに応答することを優先できます。 どちらの場合も、実装では、シグナルが別の待機スレッド (ある場合) にリダイレクトされるようにする必要があります。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。