In Range and Coerce Function

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

Add to the block diagram

Find on the palette

	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. By default, this function includes the value of lower limit and excludes the value of upper limit in the range. You can configure the function to include or exclude the values of upper limit or lower limit in the range by right-clicking the function and selecting or deselecting Include upper limit or Include lower limit from the shortcut menu. This configuration affects only the value of In Range?. This function always coerces x to the exact values of upper limit and lower limit, regardless of whether you select Include upper limit or Include lower limit.
	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.

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.

 Open example  Find related examples