|
|
|
| R2012a Documentation → Stateflow | |
Learn more about Stateflow |
|
| Contents | Index |
| On this page… |
|---|
Two types of finder tools can search for Stateflow objects.
On most platforms, when you select Tools > Find in the Stateflow Editor, the Simulink Find dialog box appears. You can use this tool to search for Simulink and Stateflow objects that meet criteria you specify. Any objects that meet your criteria appear in the search results pane of the dialog box.
For details, see The Finder in the Simulink documentation.
On platforms that do not support the Simulink Find tool, the original Stateflow Finder appears when you right-click inside a chart and select Find.
You specify the string by entering the text to search for in the Look for text box. The search is case sensitive. All text fields are included in the search by default. Alternatively, you can search in specific text fields by using the Look in list box to choose one of these options:
Any. Search the state and transition labels, object names, and descriptions of the specified object types for the string specified in the Look for field.
Label. Search the state and transition labels of the specified object types for the string specified in the Look for field.
Name. Search the Name fields of the specified object types for the string specified in the Look for field.
Description. Search the Description fields of the specified object types for the string specified in the Look for field.
Document Link. Search the Document link fields of the specified object types for the string specified in the Look for field.
Custom Code. Search custom code for the string specified in the Look for field.
By default the Search Method is Normal/Wildcard (regular expression). Alternatively, you can click the Exact Word match option if you are searching for a particular sequence of one or more words.
A regular expression is a string composed of letters, numbers, and special symbols that define one or more strings. Some characters have special meaning when used in a regular expression, while other characters are interpreted as themselves. Any other character appearing in a regular expression is ordinary, unless a \ precedes it.
Special characters supported by Stateflow Finder are as follows.
Character | Description |
|---|---|
^ | Start of string |
$ | End of string |
. | Any character |
\ | Quote the next character |
* | Match zero or more |
+ | Match one or more |
[ ] | Set of characters |
Specify the object types to search by toggling the check boxes. A check mark indicates that the object is included in the search criteria. By default, all object types are included in the search criteria. Object Type options include:
States
Transitions
Junctions
Events
Data
Targets
The Matches field displays the number of objects that match the specified search criteria.
The Search History text box displays the current search criteria. Click the pull-down list to display search refinements. An ampersand is prefixed to the search criteria to indicate a logical AND with any previously specified search criteria. You can undo a previously specified search refinement by selecting a previous entry in the search history. By changing the Search History selection, you force the Finder to use the specified criteria as the current, most refined, search output.
Click the Find button to initiate the search operation. The results appear in the display area.
After the results of a search appear, enter additional search criteria and click Refine to narrow the previously entered search criteria. An ampersand (&) is prefixed to the search criteria in the Search History field to indicate a logical AND with any previously specified search criteria.
Click Clear to clear any previously specified search criteria. By doing so, you remove the results and reset the search criteria to the default settings.
Click Help to display the Stateflow software documentation in an HTML browser window.
Click Close to close the Finder.
The Stateflow Finder display area looks something like this.
The display area shows matching entries with these columns:
Field | Description |
|---|---|
Type | The object type appears in this field. States with exclusive (OR) decomposition are followed by an (O). States with parallel (AND) decomposition are followed by (A). |
Label | The string label of the object appears in this field. |
Chart | The title of the Stateflow chart appears in this field. |
Parent | The parent of this object in the hierarchy. |
Source | Source object of a transition. |
Destination | Destination object of a transition. |
All fields are truncated to maintain column widths. The Parent, Source, and Destination fields are truncated from the left so that the name at the end of the hierarchy is readable. The entire field contents, including the truncated portion, are used for resorting.
Each field label is also a button. Click the button to have the list sorted based on that field. If the same button is pressed twice in a row, the sort ordering is reversed.
You can resize the Finder vertically to display more output rows, but you cannot expand it horizontally.
Click a graphical entry to highlight that object in the Stateflow Editor. Double-click an entry to invoke the Properties dialog box for that object. Right-click the entry to display a menu that allows you to explore, edit, or display the properties of that entry.
The Stateflow Finder shows Parent, Source, and Destination fields to represent the hierarchy. The Stateflow chart is the root of the hierarchy and is represented by the / character. Each level in the hierarchy is delimited by a period (.) character. The Source and Destination fields use the combination of the tilde (~) and the period (.) characters to denote that the state listed is relative to the Parent hierarchy.
 | Using the Search & Replace Tool | Appendices |  |
Learn how engineers use Stateflow to model state machines in their Simulink models.
| © 1984-2012- The MathWorks, Inc. - Site Help - Patents - Trademarks - Privacy Policy - Preventing Piracy - RSS |