sequencer_node テンプレート・クラス

概要

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

構文

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

ヘッダー

#include "tbb/flow_graph.h"

説明

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

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

S::S( const S& )

S::~S()

void operator=( const S& )

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( );
};
 
}
}