CompareCVIAbsoluteTimesWithTolerance
int CompareCVIAbsoluteTimesWithTolerance (CVIAbsoluteTime absoluteTime1, CVIAbsoluteTime absoluteTime2, CVITimeInterval tolerance, int *result);
Purpose
Compares the two specified absolute time values and returns 0 if they are within the specified tolerance interval. If not, the function returns -1 if the first value is less than the second value and returns 1 if the first value is greater than the second value. An absolute time value is less than another if it occurred, occurs, or will occur before the other time value.
Parameters
| Input | ||
| Name | Type | Description |
| absoluteTime1 | CVIAbsoluteTime | Absolute time value in National Instruments Binary Time Format. |
| absoluteTime2 | CVIAbsoluteTime | Absolute time value in National Instruments Binary Time Format. |
| tolerance | CVITimeInterval | The time interval value used for equality comparison. Valid tolerance values must be zero or positive. |
| Output | ||
| Name | Type | Description |
| result | int | The result of the comparison. The function returns 0 if the first value is within the tolerance interval of the second value, -1 if the first value is less than the second value, and 1 if the first value is greater than the second value. |
Return Value
| Name | Type | Description | |||||||||||||||||||||
| status | int | The result of the function call. Negative values represent errors. The following table describes the results that this function returns.
|
Additional Information
Library: Utility Library
Include file: utility.h
LabWindows/CVI compatibility: LabWindows/CVI 9.0 and later