ISGREATEREQUAL(3POSIX)

πŸ’– ISGREATEREQUAL(3POSIX) πŸ’–

okay bestie, welcome to the POSIX Programmer's Manual ✨ this one's called isgreaterequal, and it lives in section 3POSIX of the POSIX Programmer's Manual. sit down, hydrate, let's go 🫢


🌸 PROLOG 🌸

so real talk: this manual page is part of the POSIX Programmer's Manual. the Linux implementation of this interface might be different (like, go check the corresponding Linux manual page for the tea on Linux behavior β˜•), or honestly the interface might not even be implemented on Linux at all. no cap.


✨ NAME ✨

isgreaterequal β€” test if x is greater than or equal to y πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

#include <math.h>

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

πŸ¦‹ DESCRIPTION πŸ¦‹

the functionality described on this reference page is aligned with the ISO C standard. any conflict between the requirements described here and the ISO C standard is unintentional β€” like, not on purpose at all. this volume of POSIX.1‐2017 defers to the ISO C standard. periodt.

the isgreaterequal() macro shall determine whether its first argument is greater than or equal to its second argument. the value of isgreaterequal(x, y) shall be equal to (x) β‰₯ (y) β€” same energy, same result β€” however!! unlike (x) β‰₯ (y), isgreaterequal(x, y) shall not raise the invalid floating-point exception when x and y are unordered. that's the whole glow-up, bestie πŸ”₯


πŸ’« RETURN VALUE πŸ’«

upon successful completion, the isgreaterequal() macro shall return the value of (x) β‰₯ (y).

if x or y is NaN, 0 shall be returned. yeah. zero. that's the vibe πŸ™ˆ


πŸ’€ ERRORS πŸ’€

no errors are defined. not a single one. iconic.

the following sections are informative.


🌈 EXAMPLES 🌈

none. (not me giving you zero examples 😭)


πŸ‘‘ APPLICATION 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 may 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 NaNs without suffering the invalid floating-point exception. slay.

in the SYNOPSIS section, real-floating indicates that the argument shall be an expression of real-floating type. important!! πŸŽ€

🧚 RATIONALE 🧚

none. (the reasoning? immaculate. undocumented, but immaculate ✨)


⭐ FUTURE DIRECTIONS ⭐

none. the future is undefined but the vibes are stable πŸ’œ


πŸ”₯ SEE ALSO πŸ”₯

  • isgreater()
  • isless()
  • islessequal()
  • islessgreater()
  • isunordered()

the Base Definitions volume of POSIX.1‐2017, <math.h> πŸ“š


portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group.

in the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. the original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. to report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .


and that's the whole page, bestie!! brought to you by IEEE/The Open Group, dated 2017, filed under ISGREATEREQUAL(3POSIX). go forth and compare floats responsibly πŸ«ΆπŸ’–βœ¨