sequencer_node テンプレート・クラス

概要

T 型のメッセージの無制限バッファー。メッセージはシーケンス順に転送されます。

構文

template< typename T, typename A = cache_aligned_allocator<T> >
class sequencer_node;

ヘッダー

#include "tbb/flow_graph.h"

説明

sequencer_node は、サクセサーセットの 1 つのサクセサーへシーケンス順にメッセージを転送する graph_node、receiver<T>、sender<T> です。ノードに登録された順番で、サクセサーにメッセージが転送されます。サクセサーがメッセージを拒否すると、そのサクセサーはメッセージ・パッシング・プロトコルのポリシーに従ってサクセサーリストから削除され、セットの次のサクセサーが処理されます。これはサクセサーがメッセージを受け付けるまで、またはすべてのサクセサーが処理されるまで続行されます。サクセサーに転送されたアイテムはバッファーから削除されます。

sequencer_node から渡される各アイテムは、シーケンサーのオーダー番号によって順序が決められます。これらのシーケンスオーダー番号の範囲は 0 から N (N は size_t 型で表現可能な最も大きな整数) です。アイテムのシーケンサー・オーダー番号は、下記のように、シーケンサー・コンセプトをモデル化するユーザー定義関数オブジェクトにアイテムを渡すことにより決定されます。

sequencer_node は予約可能で、一度に 1 つの予約をサポートします。sequencer_node が予約されている間、ほかのアイテムはサクセサーに転送されず、try_get の呼び出しは false を返します。予約されている間も、try_put は true を返し、sequencer_node にアイテムを追加します。

A 型のアロケーターが、sequencer_node に内部メモリーを割り当てるために使用されます。

T は、コピー構築可能および代入可能でなければなりません。

サクセサーがメッセージを拒否した場合、「メッセージ・パッシング・プロトコル」で説明されているプロトコルを使用して処理されます。

メンバー

namespace tbb {
namespace flow {

template< typename T, typename A = cache_aligned_allocator<T> >
class sequencer_node :
  public queue_node<T> {
public:
    template< typename Sequencer >
    sequencer_node( graph &g, const Sequencer &s );
    sequencer_node( const sequencer_node &src );

    // receiver<T>
    typedef T input_type;
    typedef sender<input_type> predecessor_type;
    bool try_put( const input_type &v );
    bool register_predecessor( predecessor_type &p );
    bool remove_predecessor( predecessor_type &p );

    // sender<T>
    typedef T output_type;
    typedef receiver<output_type> successor_type;
    bool register_successor( successor_type &r );
    bool remove_successor( successor_type &r );
    bool try_get( output_type &v );
    bool try_reserve( output_type &v );
    bool try_release( );
    bool try_consume( );
};

}
}