In Range and Coerce Function

FlexRIO Help

Edition Date: November 2015

Part Number: 372614J-01

»View Product Info

»Download the Help in ZIP Format

Owning Palette: Comparison Functions

Requires: Base Development System

Determines whether x falls within a range specified by the upper limit and lower limit inputs and optionally coerces the value to fall within the range. The function performs the coercion only in Compare Elements mode. This function accepts time stamp values if all inputs are time stamp values. You can change the comparison mode of this function.

The connector pane displays the default data types for this polymorphic function.

Details  Example

upper limit, x, and lower limit should usually be of the same data type structure, either arrays or clusters, but they can have different numeric representations. For example, if you change one of the data types to an array, you must change the remaining data types to arrays to avoid broken wires. However, you can wire an array to x and two scalars to upper limit and lower limit. You also can wire double-precision, floating-point and integer data.
coerced(x) returns the coerced or unchanged value of x. If x is within the range set by the upper limit and lower limit inputs or if the function is in Compare Aggregates mode, the value is unchanged. If x is not in range and the function is in Compare Elements mode, the function converts the value to the same value as upper limit or lower limit. If upper limit, x, or lower limit is NaN, coerced(x) is NaN.
In Range? is a Boolean value in Compare Aggregates mode. In Compare Elements mode, the data type structure of In Range? matches the data type structure of x, with each scalar replaced by a Boolean value. If upper limit, x, or lower limit is NaN, In Range? is FALSE.

In Range and Coerce Details

This function compares the input data values according to the Boolean comparison rules. If the function is in Compare Aggregates mode, it returns the unchanged value of x in coerced(x) rather than a coerced value. The function considers each input array as a single aggregate object, similar to a cluster, where the first element is primary in the comparison. If x is greater than upper limit and the function is in Compare Elements mode (default), the function coerces x to the upper limit value. If x is less than lower limit and the function is in Compare Elements mode, the function coerces x to the lower limit value.

If you wire a combination of signed and unsigned integers to the upper limit, x, and lower limit inputs of the In Range and Coerce function, all of the inputs will be coerced to the same unsigned integer type. This can lead to unexpected results for negative input values. For example, wiring an unsigned integer to upper limit and a negative signed integer to lower limit may cause LabVIEW to interpret the lower limit input as larger than the upper limit input. To avoid this issue, convert integer inputs to the same type before you wire them to the In Range and Coerce function.

By default, In Range And Coerce includes the lower limit value in the range, as indicated by the solid black diamond at the lower limit input. By default, the upper limit value is not included in the range, as indicated by the empty diamond at the upper limit input.

To change whether the function includes the value wired to upper limit or lower limit, right-click the function and select Include upper limit or Include lower limit from the shortcut menu to include or remove the value in the range. These options only affect the result of In Range?. The function always coerces x to the exact values of upper limit or lower limit, regardless of whether you select Include upper limit or Include lower limit from the shortcut menu.

If the lower limit value is greater than the upper limit value, In Range? is always FALSE and LabVIEW switches the lower limit value and the upper limit value internally before computing coerced(x).

Example

Refer to the In Range and Coerce VI in the labview\examples\Comparison directory for an example of using the In Range and Coerce function.

WAS THIS ARTICLE HELPFUL?

Not Helpful