中断付き読み取り
- 更新日2025-07-30
- 4分で読める
メッセンジャーチャンネルから要素を読み取るか、チャンネルを中断させます。このエンドポイントは、中断入力と中断された?出力が付いている以外は読み取りエンドポイントと同じです。メッセンジャーチャンネルの中断機能を使用すると、チャンネルバッファに残っているデータを無視して、即時にチャンネルを閉じることができます。このエンドポイントは、中断付き書き込みエンドポイントと併せて使用する必要があります。

入力/出力
タイムアウト入力 (ms) (-1)
—
タイムアウト入力 (ms) は、このエンドポイントがチャンネルから要素を読み取る時間 (ミリ秒) です。デフォルト値は-1のため、時間制限はありません。
チャンネル
—
チャンネルは、このエンドポイントを書き込みエンドポイントに接続するチャンネルワイヤです。
ack id (0)
—
ack idは、肯定応答するメッセージのID番号を指定します。この入力により、エンドポイントは前のメッセージの受信を肯定応答できます。この入力をAck書き込みエンドポイントの代わりとして使用してチャンネルで肯定応答を有効にできます。各反復でメッセージの読み取り後に「Ack書き込み」を使用するか、この入力を使用して読み取りエンドポイントが前のメッセージを肯定応答してから次のメッセージを読み取るようにできます。デフォルトは0です。
中断 (F)
—
中断は、このチャンネルを中断するかどうかを指定します。デフォルトはFALSEです。中断がTRUEの場合、このエンドポイントはチャンネルを終了とマークし、それ以降の読み取り呼び出しを無視します。一方、中断された?は、このエンドポイントの次の呼び出しでTRUEを返します。
タイムアウト?
—
タイムアウト?は、タイムアウト入力 (ms) に指定された値を経過するとTRUEを返します。
要素
—
要素は、チャンネルから読み取るデータを返します。
残り
—
残りは、この読み取り操作後にチャンネルに残る要素の数を返します。
中断された?
—
中断された?は、このエンドポイントまたはチャンネルに接続されている書き込みエンドポイントで中断が発生した場合にTRUEを返します。中断された?がTRUEの場合、それ以降のこのエンドポイントの呼び出しは、再度中断された?がTRUEを返す以外はなにもしません。 |
タイムアウト入力 (ms) (-1)
—
チャンネル
—
ack id (0)
—
中断 (F)
—
タイムアウト?
—
要素
—
MessageAckBase.lvclass
—
残り
—