The
CheckRange condition checks to see if a numeric value lies within a given range. It uses the properties
ApplyTo,
Offset,
Length,
UseDataAvail and
IfNull to determine what data is to be converted to a numeric value and what the return value should be if the data isn't available
or the conversion fails. Also see section “Specifying Data for Conditions”.
Range Attribute
| Type
|
Numeric Ranges
|
| Default
|
-
|
| Description
|
Specifies the allowed range for the numeric value.
|
Convert Attribute
| Type
|
Distinct Values
|
| Default
|
Length
|
| Description
|
Specifies how to convert the data (obtained through the properties
Apply,
Offset,
Length, and
UseDataAvail) into a number.
|
Allowed values are:
| Length (default)
|
The data is converted to a number by measuring the length (number of bytes) of the data.
|
| Parse
|
The data is converted to a number by assuming a textual numeric value and parsing it. If parsing fails, no range check is
performed and the attribute IfNull determines the result of the condition.
|
| LittleEndian
|
The data is treated as a binary representation of a number in little endian format. If the data is empty or is longer than
4 bytes, this fails and the attribute IfNull determines the result of the condition.
|
| BigEndian
|
The data is treated as a binary representation of a number in big endian format. If the data is empty or is longer than 4
bytes, this leads to a failure and the attribute IfNull determines the result of the condition.
|
Example
<CheckRange>
<ApplyTo>Http.Response.StatusCode</ApplyTo>
<Range>200-299</Range>
<Convert>Parse</Convert>
</CheckRange>