RELATIONALFUNCTIONS(3clc)

💖 RELATIONAL BUILT-IN 💖

okay bestie, welcome to the relational built-in page of the OpenCL Manual — this is RELATIONAL BUILT-IN(3clc), and it's basically a little link menu: click an item in the table below for details about that function. 🫶

Every single one of these is component-wise coded, so let's get into it. 🌈

---

✨ NAME ✨

Relational_Built-In_Functions — click an item in the table below for details about that function. 🎀

The original table was a whole grid moment, so here it is as the same list of entries with the exact same tea:

• isequal(3clc) — Component-wise compare of x == y.
• isnotequal(3clc) — Component-wise compare of x != y.
• isgreater(3clc) — Component-wise compare of x > y.
• isgreaterequal(3clc) — Component-wise compare of x >= y.
• isless(3clc) — Component-wise compare of x < y.
• islessequal(3clc) — Component-wise compare of x <= y.
• islessgreater(3clc) — Component-wise compare of (x < y) || (x > y).
• isfinite(3clc) — Test for finite value.
• isinf(3clc) — Test for positive or negative infinity.
• isnan(3clc) — Test for a NaN.
• isnormal(3clc) — Test for a normal value.
• isordered(3clc) — Test if arguments are ordered.
• isunordered(3clc) — Test if arguments are unordered.
• signbit(3clc) — Test for sign bit.
• any(3clc) — 1 if MSB in any component of x is set; else 0.
• any(3clc) — 1 if MSB in all components of x is set; else 0. (no bestie, that's not me glitching — the table really does say any(3clc) again here, i'm just relaying it 💀)
• bitselect(3clc) — Each bit of result is corresponding bit of a if corresponding bit of c is 0.
• select(3clc) — For each component of a vector type, result[i] = if MSB of c[i] is set ? b[i] : a[i] For scalar type, result = c ? b : a.

---

🌸 DESCRIPTION 🌸

okay so here's the one detail that actually matters, no cap: if an implementation extends this specification to support IEEE-754 flags or exceptions, then all built-in relational functions shall proceed without raising the invalid floating-point exception when one or more of the operands are NaNs. ✨

like… NaN showing up is not a crisis, it's just Tuesday. no invalid exception drama. 🙈

---

👑 SPECIFICATION 👑

OpenCL Specification[1] 📚

---

💅 AUTHORS 💅

The Khronos Group 👑

---

🎀 COPYRIGHT 🎀

Copyright © 2007-2011 The Khronos Group Inc.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Materials.

---

🧚 NOTES 🧚

1. OpenCL Specification page 264, section 6.12.6 - Relational Functions

---

and that's the whole page, bestie!! 🦋 this one came straight from The Khronos Group, dated 01/14/2021, and it's the RELATIONAL BUILT-IN(3clc) page from the OpenCL Manual — go forth and compare component-wise, you absolute icon. 💜🔥