MakeDynamicAnalyzerGroup

The C++ Build Insights SDK is compatible with Visual Studio 2017 and above. To see the documentation for these versions, set the Visual Studio Version selector control for this article to Visual Studio 2017 or Visual Studio 2019. It's found at the top of the table of contents on this page.

The MakeDynamicAnalyzerGroup function is used to create a dynamic analyzer group. Members of an analyzer group receive events one by one from left to right, until all events in a trace get analyzed.

Syntax

auto MakeDynamicAnalyzerGroup(std::vector<IAnalyzer*> analyzers);

auto MakeDynamicAnalyzerGroup(std::vector<std::shared_ptr<IAnalyzer>> analyzers);

auto MakeDynamicAnalyzerGroup(std::vector<std::unique_ptr<IAnalyzer>> analyzers);

Parameters

analyzers
A vector of IAnalyzer pointers included in the dynamic analyzer group. These pointers can be raw, std::unique_ptr, or std::shared_ptr.

Return Value

A dynamic analyzer group. Use the auto keyword to capture the return value.

Remarks

Unlike static analyzer groups, the members of a dynamic analyzer group don't need to be known at compile time. You can choose analyzer group members at runtime based on program input, or based on other values that are unknown at compile time. Unlike static analyzer groups, IAnalyzer pointers within a dynamic analyzer group have polymorphic behavior, and virtual function calls are dispatched correctly. This flexibility comes at the cost of a possibly slower event processing time. When all analyzer group members are known at compile time, and if you don't need polymorphic behavior, consider using a static analyzer group. To use a static analyzer group, call MakeStaticAnalyzerGroup instead.

A dynamic analyzer group can be encapsulated inside a static analyzer group. It's done by passing its address to MakeStaticAnalyzerGroup. Use this technique for passing dynamic analyzer groups to functions such as Analyze, which only accept static analyzer groups.