ATOMIC_OR(3clc)

💅 ATOMIC_OR — the OpenCL Manual, bestie edition 🎀

okay so this is ATOMIC_OR(3clc) from the OpenCL Manual, and it's literally about one little function that does one little thing and does it flawlessly. main character energy fr fr ✨

---

✨ NAME ✨

atomic_or — the atomic_or functions. that's it, that's the name, she's iconic 💖

int atomic_or(volatile global(3clc) int *p, int val);

unsigned int atomic_or(volatile global(3clc) unsigned int *p,
                       unsigned int val);

int atomic_or(volatile local(3clc) int *p, int val);

unsigned int atomic_or(volatile local(3clc) unsigned int *p,
                       unsigned int val);

like… four flavors of the same slay. pick your address space, pick your signedness, go off 👑

---

🌸 DESCRIPTION 🌸

so here's the vibe. you point her at a location with p, she reads the 32-bit value sitting there — we call that one old, cute — then she computes (old | val) and stores that result right back at the location pointed to by p. and then? she returns old. the original. the before pic. not the glow-up, the pre-glow-up. periodt 💅

also!! there's a 64-bit version of this function, atom_or(3clc) — and heads up, that one is only enabled by cl_khr_int64_extended_atomics(3clc). so no extension, no 64-bit, no cap 🧚

---

📜 SPECIFICATION 📜

OpenCL Specification[1] — yeah that's the whole section, she's brief and she knows it 🎀

---

🦋 SEE ALSO 🦋

• atomicFunctions(3clc)
• atom_or(3clc)

go read those too, iykyk 🫶

---

👑 AUTHORS 👑

The Khronos Group. absolute legends, no notes 🔥

---

💜 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 condition: the above copyright notice and this permission notice shall be included in all copies or substantial portions of the Materials.

bestie this is a legal notice so i'm keeping it verbatim — no edits, no remix, it's giving "read the terms" energy 😭 but like, respectfully.

---

📝 NOTES 📝

1. OpenCL Specification, page 279, section 6.12.11 - Atomic Functions for 32-bit integers

---

and that's the whole page, we ate and left no crumbs 🍓

shoutout to The Khronos Group, 01/14/2021, from the ATOMIC_OR(3clc) era — bye bestie, go atomically OR something 🌈💖