Go to main content

man pages section 3: Extended Library Functions, Volume 2

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

islessequal(3M)

Name

islessequal - test if x is less than or equal to y

Synopsis

c99 [ flag... ] file... –lm [ library... ]
#include <math.h>

int islessequal(real-floating x, real-floating y);

Description

The islessequal() macro determines whether its first argument is less than or equal to its second argument. The value of islessequal(x, y) is equal to (x) ≤ (y); however, unlike (x) ≤ (y), islessequal(x, y) does not raise the invalid floating-point exception when x and y are unordered.

Return Values

Upon successful completion, the islessequal() macro returns the value of (x) ≤ (y).

If x or y is NaN, 0 is returned.

Errors

No errors are defined.

Usage

The relational and equality operators support the usual mathematical relationships between numeric values. For any ordered pair of numeric values, exactly one of the relationships (less, greater, and equal) is true. Relational operators can raise the invalid floating-point exception when argument values are NaNs. For a NaN and a numeric value, or for two NaNs, just the unordered relationship is true. This macro is a quiet (non-floating-point exception raising) version of a relational operator. It facilitates writing efficient code that accounts for quiet NaNs without suffering the invalid floating-point exception. In the SYNOPSIS section, real-floating indicates that the argument is an expression of real-floating type.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
Availability
system/library/math
MT-Level
MT-Safe
Standard

See Also

math.h(3HEAD), isgreater(3M), isgreaterequal(3M), isless(3M), islessgreater(3M), isunordered(3M), attributes(7), standards(7)