RealView® Developer Kit Debugger User Guide 9.2.3. Applying a filter

9.2.3. Applying a filter

Using a filter enables you to narrow down the search when displaying the list of images, modules, functions, or variables in the Data Navigator pane. When you specify a filter, the list of functions and variables is filtered accordingly. That is, only those functions and variables that match the filter are displayed.

Filter syntax

The syntax for specifying a filter is:

For modules:
@image_name\module_name\*
The \* suffix is optional.
For functions:
@image_name\module_name\function_name
For variables:
@image_name\module_name\variable_name

Module names qualify symbolic references. See Module naming conventions for details on using module names.

Filter metacharacters

Table 9.1 shows the metacharacters you can use to specify the filter rule or rules. When entering a filter, characters are case sensitive, for example the filter *DHRY* returns a list of three modules but *dhry* returns an empty list.

When you have completed the filter, press Enter and the list is refreshed. By repeatedly entering filters, and pressing Enter, you can refine the search to focus on selected modules, files, functions or variables.

Table 9.1. Filter metacharacters

Metacharacter	Description
`*`	This operator matches any character or number of characters, for example `DHRY` matches `MY_DHRYSTONE_H` but not `Dhrystone_H` or `MY_DHR`.
`?`	This operator matches any single character, for example `*DHRY_?`. matches `MY_DHRY_A` but not `MY_DHRY_AB` or `DHRY_B`.
`[…]`	List operators enable you to define a set of items to use as a filter. The list items must be enclosed by square brackets, for example `[HN]` matches `DHRY_H` and `UNNAMED_1` but not `STDLIB`. An empty list (`[]`) returns no results.
`^`	This operator is used inside a list, to represent a NOT action, for example `_[^2]` matches `DHRY_1` but not `DHRY_2`.
`-`	Range operators enable you to define a range of items to use as a match. The range must be enclosed within square brackets, for example `_[A-Z]` matches `DHRY_H` but not `DHRY_1` whereas `_[^A-Z]` matches `UNNAMED_1` but not `DHRY_H.`
`-`	Used as the first character in a filter, this operator means do not match. For example, `SAM -HOST` means match all names containing the string `SAM` except those that contain the string `HOST`.

Copyright © 2005, 2006 ARM Limited. All rights reserved.	ARM DUI 0281C
Non-Confidential
PDF version