Filtering Data by Pattern (Memory Profiling)

Related Topics

 

1.    Open the Filter Manager dialog box.

2.    Select the Methods tab.

3.    Select a pattern to use to filter data from the current dataset. For example, *foo* or Foo*.

4.    Click the selected pattern's checkbox to enable the filter.

5.    For the selected pattern, click Retain to continue including the memory data of filtered methods in the method + descendants (M+D) bytes of their callers, or click Delete to delete the memory data.

Notes:

§      Filters work only on methods, they cannot be applied to objects.

§      The pattern is always matched against the full method name, regardless of the settings in the Method Name dialog box.

§      Pattern string matching is case-sensitive.

§      To add a pattern, type a pattern string and click Add. You can use an asterisk (*) to denote a character string of any length; use a backslash (\) with the asterisk if the method name itself contains an asterisk. For example:

 

This pattern

Matches any method whose name

Com.*

Begins with Com. and is followed by any string

*chr

Starts with any string and ends in chr

*str*

Contains str

delete(void\*

Is delete and whose first argument is void*

§      To edit a pattern, simply click the selected pattern to edit it in place, or right-click the selected pattern and select Rename from the shortcut menu.

§      To disable a filter, clear the selected pattern's checkbox. The methods are restored to the current dataset and, if their memory data had been deleted, the memory data for the dataset is recalculated. You can also delete a selected pattern by clicking Remove.

§      Right-click a selected pattern to display a shortcut menu for working with the filter.

§      When you're working in the Call Graph or Function List View, or in the Function Detail window, you can quickly filter methods by pattern. Select a method, right-click in the window, and select Filter > Hide Method methodname or Delete Method methodname from the shortcut menu, depending on whether you want to retain or delete the memory data. The method name (which is a pattern) is added to the Filter list in the Filter Manager dialog box.

§      Purify automatically saves the filters you create in the filter file exeName_exe.mft. For details about filter file names and their locations, click images\shortcut.gif.

(C) Copyright IBM Corporation 1992, 2010.