Mask Property (ATest)

Returns or sets an integer mask to identify the bits to use for comparison in the hexadecimal Ref-X/2 Test types.

Syntax

Object.Mask [ = lMask ]

The Mask property syntax has the following parts:

 

Name

Type

Description

Object

ATest

ATest object

lMask

Long

An integer specifying the hexadecimal reference mask to identify the bits to use for comparison in the hexadecimal Ref Test. A bit that has a 1 value represent a bit in result that should be compared, while 0 bit value means that the bit is not compared or ignored.

Comment

This Mask property value is a 32 bit number, a 1 value bit represents the bits that are compared while a 0 value bit are ignored and not compared. TestResult Variable is used as  a result to determine if the test pass or failed. The property is set by the ATEasy run-time from the test properties window at the start of the test. You can override that value by setting this value setting the property value at run-time.

Example

The following statement shows how to set the number used to identify the bits used for comparison in the hexadecimal Ref Test:

Test.Mask = 0x21 ! error bits in device status register, only bit 0 and 5 are checked

Applies to

ATest

See Also

Ref, Ref2, TestRefResult Variable