source_node クラス

概要

graph_node および sender<Output> のテンプレート・クラス。このノードにはプレデセッサーはありません。ユーザー定義 body 関数オブジェクトを実行して、すべてのサクセサーにブロードキャストされるメッセージを生成します。このノードはシリアルノードで、body を同時に呼び出しません。1 つのアイテムをバッファーに格納できます。生成されたアイテムを受け付けるサクセサーがない場合、新しいアイテムが生成される前のサクセサーに提供されます。

構文

template < typename Output > class source_node;

ヘッダー

#include "tbb/flow_graph.h"

説明

このノードは、ユーザー定義 body を呼び出して Output 型のメッセージを生成し、結果をすべてのサクセサーにブロードキャストします。

source_node はシリアルノードです。body の呼び出しは同時に行われません。

source_node は、body が false を返すか有効なサクセサーがなくなるまで、body の呼び出しとメッセージのブロードキャストを続行します。メッセージが生成された後、すべてのサクセサーで拒否される場合があります。この場合、メッセージはバッファーに格納され、サクセサーがノードに追加されるか try_get が呼び出されると、次のメッセージが送られます。try_get の呼び出しは、メッセージがバッファーに格納されている場合はそのメッセージを返します。格納されていない場合は body を呼び出して新しいメッセージを生成しようとします。body の呼び出しは内部バッファーが空の場合のみ行われます。

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

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

メンバー

namespace tbb {
namespace flow {
 
template < typename Output >
class source_node : public graph_node, public sender< Output > {
public:
    typedef Output output_type;
    typedef receiver< output_type > successor_type;
 
    template< typename Body >
    source_node( graph &g, Body body, bool is_active = true );
    source_node( const source_node &src );
    ~source_node();
 
    void activate();
    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( );
};
 
}
}