slreportgen.finder.EnumerationTypeFinder Class

Namespace: slreportgen.finder

Find enumerated data types used in Simulink model

Since R2023b

Description

Use objects of the class slreportgen.finder.EnumerationTypeFinder to find which enumerated data types are used in a Simulink^® model or subsystem.

The slreportgen.finder.EnumerationTypeFinder class is a handle class.

Class Attributes

HandleCompatible

true

For information on class attributes, see Class Attributes.

Creation

Description

finder = slreportgen.finder.EnumerationTypeFinder(container) creates a finder that finds variables used in the specified container, which can be a Simulink model or subsystem. See the Container property. To specify the container, use a Simulink model or subsystem block path or handle. You can constrain the search to a specific enumeration type name, user, or type of workspace by setting the properties of the finder. Use the finder's find or next method to perform the search.

Note

This finder provides these options to get search results:

• To return the search results as an array, use the find method. Add the results directly to a report or process the results in a for-loop.

• To iterate through the results one at a time, use the hasNext and next methods in a while-loop.

Neither option has a performance advantage.

finder = slreportgen.finder.EnumerationTypeFinder(Name=Value) sets Properties using one or more name-value arguments. You can specify multiple name-value pair arguments in any order.

Properties

Container — Model or subsystem to search

string scalar | character vector | handle

Model or subsystem to search, specified as a string scalar or character vector that contains the path to the model or subsystem, or as a handle to the model or subsystem.

Data Types: string | char | handle

Name — Enumerated type to find

[] (default) | string scalar | character vector

Name of an enumerated type to find, specified as a string scalar or character vector. If you do not specify a name, then enumeration types are not filtered based on the name property. This property can include regular expressions if Regexp is set to true.

Data Types: string | char

Users — Name of the users to search for enumerated data types

[] (default) | string scalar | character vector

Names of systems that use an enumeration types to be found, specified as a string scalar or character vector (to specify a single system) or an array of strings or cell array of character vectors (to specify multiple systems/charts). The finder returns the enumeration types used by a model or chart specified in this property. If the value of the Regexp property is true, the finder treats users names in this property as regular expressions and returns enumeration types used by systems whose names match the regular expressions. If this property is empty, the finder does not filter enumeration types based on users.

Data Types: string | char

SourceType — Type of source that defines an enumeration type

"all" (default) | "MATLAB file" | "dynamic class" | "data dictionary"

Originating workspace type that defines the enumerated data type, specified as one these values:

• "all"

• "MATLAB file"

• "dynamic class"

• "data dictionary"

Source Type	Value	Description
MATLAB® file	"BasicColors.m"	The enumerated type is defined in the MATLAB file BasicColors.m.
Dynamic class	"Simulink.defineIntEnumType"	The enumerated type is defined dynamically and has no source. An enumerated type is defined dynamically when you define it using the function Simulink.defineIntEnumType. With this function, you can specify enumerated types you define externally to MATLAB that you want to import for use within the Simulink environment.
Data dictionary	"sldemo_fuelsys_dd_controller.sldd"	The enumerated type is defined in the data dictionary named sldemo_fuelsys_dd_controller.sldd.

Data Types: string

Properties — Properties of Simulink.VariableUsage objects to find

string scalar | character vector

Properties of Simulink.VariableUsage objects to find, specified as a cell array of name-value arguments. The finder returns only those enumerated data types whose associated Simulink.VariableUsage object has the specified property values.

Example: finder.Properties = {"SourceType","MATLAB file"}

Data Types: string | char

Regexp — Regular expression matching

false (default) | true

Regular expression matching, specified as false or true. If Regexp is false, regular expression matching is not enabled. If Regexp is true, regular expression matching is enabled for the values of the Name and Users properties. For example, this code finds variables that start with vehicle.

Run the following command to access the supporting files used in this example.

openExample('rptgenext/SimulinkReportGeneratorFilesExample');

finder = slreportgen.finder.EnumerationTypeFinder("sf_car");
finder.Regexp = true;
finder.Name = "^vehicle";

You can match only those input arguments that have character vector values.

Data Types: logical

SearchMethod — Compile status

"compiled" (default) | "cached"

Compiled status of the models, specified as one of the values in the table.

Value	Description
"compiled"	Get up-to-date results by compiling models before the search.
"cached"	Get results more quickly by using data cached during the previous compilation.

SearchReferencedModels — Whether to search in referenced models

true or 1 (default) | false or 0

Whether to search in the referenced models, specified as a logical 1 (true) or 0 (false). You can search in models that are referenced by the model or referenced by a block represented by the Container property. When SearchReferencedModels is true:

• The finder searches only referenced models within the search depth.

• The finder searches referenced models to the depth specified by SearchDepth, regardless of the depth of the block that contains the referenced model.

• The finder searches models that are referenced by referenced models.

Note

You can also set the SearchReferencedModels property by using "off" and "on".

Data Types: logical

Methods

Public Methods

find	results = find(finder) returns function references that match the constraints specified by the EnumerationTypeFinder object as an array of slreportgen.finder.EnumerationTypeResult objects. You can add all of the result objects either directly to a report or process the results in a loop. In the loop, you can customize the content and formatting of an enumeration type by setting the properties of the reporter. To get the reporter object, you can use the getReporter method of the slreportgen.finder.EnumerationTypeResult.
next	result = next(finder)returns the next search result in the result queue created by the finder's hasNext method. This method returns the enumeration type that it finds wrapped in a result object of type slreportgen.finder.EnumerationTypeResult. Use hasNext and next methods to iterate through found enumeration types in a while-loop. In the loop, you can customize the content and formatting of an enumeration type by setting the properties of the reporter. You can get the reporter object by using the getReporter method of the slreportgen.finder.EnumerationTypeResult class.
hasNext	tf = hasNext(finder) determines if the model to be searched by finder contains at least one enumeration type. If so, it queues that enumeration type as the next variable to be returned by the finder's next method. Use the finder's next method to obtain that enumeration type. On subsequent invocations, this method determines if the model has an enumeration type that has not yet been retrieved by the next method. If so, this method queues that enumeration type as the next variable to be retrieved by the next method and returns true. If the enumeration type queue is empty, this method returns false. You can use this method with the finder's next method in a while loop to progressively search a model for enumeration types.

Examples

Add Enumeration Types to a Report

This example shows you how to add enumeration types in a model to a report.

Create a Simulink Report.

rpt = slreportgen.report.Report("MyReport","pdf");

Create a chapter.

chapter = mlreportgen.report.Chapter();
chapter.Title = "EnumerationType Example";

Load the model.

model_name = "slrgex_datatypedemo";
load_system(model_name);

Create an enumeration type finder and set its properties to constrain the search.

finder = slreportgen.finder.EnumerationTypeFinder(model_name);
finder.SourceType = "MATLAB file";

Find enumeration types used by the model.

results = find(finder);

Add the results to the chapter.

append(chapter,results);

Add chapter to the report.

append(rpt,chapter);

Close and view the report.

close(rpt);
rptview(rpt);

Version History

Introduced in R2023b