Filter Field—Filtering Array Values

TotalView Online Help : Variable Window : Variable Window Overview : Filter Field—Filtering Array Values

You can tell TotalView that it should selectively display information from the array by entering a value in the Filter field.

While there are a number of ways to specify a filter, the general format is:

operator value

where operator is one or more of the following:

<, <=, >, >=, ==, !=

.lt. .le. .gt. .ge. .eq. .ne.

value can be a constant integer or real value. For example:

> 0

You can also enter a TotalView intrinsic, which is a built-in representation of IEEE floating-point NaN (Not a Number), INF (infinity), or denormalized value. These intrinsics are:


Intrinsic	Meaning
$nan	any NaN (Not a Number)
$nanq	quiet NaN (Not a Number)
$nans	signaling NaN (Not a Number)
$inf	any INF, either positive or negative
$ninf	negative INF
$pinf	positive INF
$denorm	denormalized number, either positive or negative
$pdenorm	positive denormalized number
$ndenorm	negative denormalized number

You can only use the == and != operators with these intrinsics. For example, != $denorm.

You can add a second component to the filter to indicate that TotalView should show elements contained within a range by using the following format:

[>]low_value:[<]high_value

Here are some points to consider:

low_value and high_value are constant integers or real values.

You can apply the < and > operators to the low and high values to allow for exclusive ranges. By default, the range is inclusive of the lower and upper values.

low_value and high_value cannot be of different types. For example, the following range is invalid:

1:2000u

1.0:2000

You can use the $value token to represent the current array element. For example:

$value > 0 && $value < 100

This filter expression tells TotalView to displays all array elements that are greater than 0 and less than 100.

Your filter can also contain program variables. For example:

$value != x && $value < y

You cannot use function calls in a filter expression.

For more information, see Setting Action Points in the TotalView Users Guide.