Filtering Array Data

The procedure for filtering an array is quite simple: select the Filter field, enter the array filter expression, and then press Return.

TotalView updates the Variable Window to exclude only the elements that do not match the filter expression.

TotalView applies the filter expression to each element of the array after any array slice is applied. TotalView displays the element if its value matches the filter expression.

If necessary, TotalView converts the array element before evaluating the filter expression. The following conversion rules apply:

• If the filter operand or array element type is floating-point, TotalView converts it to a double-precision floating-point value. Extended-precision values are truncated to double precision. Converting integer or unsigned integer values to double-precision values may result in a loss of precision. Unsigned integer values are converted to non-negative double-precision values.
   
• If the filter operand or the array element is an unsigned integer, TotalView converts the values to an unsigned 64-bit integer.
   
• If both the filter operand and array element are of type integer, TotalView converts the values to type 64-bit integer.

These conversions modify a copy of the array's elements--they never alter the actual array elements.

To stop filtering an array, delete the contents of the Filter field in the Variable Window and press Return. TotalView will then update the Variable Window so that it includes all elements.