SDL_RectsEqual(3)

💖 SDL_RectsEqual(3) 💖

okay bestie, welcome to the SDL3 FUNCTIONS section of the manual, and today's main character is SDL_RectsEqual — the little header function that tells you whether two rectangles are, like, the same rectangle. 🦋

---

✨ NAME ✨

SDL_RectsEqual — figure out whether two rectangles are equal, no cap. 🎀

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_rect.h>

SDL_FORCE_INLINE bool SDL_RectsEqual(const SDL_Rect *a, const SDL_Rect *b);

---

✨ DESCRIPTION ✨

so here's the vibe check: two rectangles count as equal only if both of them are not NULL and each of their x, y, width and height all match. every single one. all four. no skipping. 💅

⚠️ now the important part, bestie, listen up: this is a forced-inline function in a header, not a public API function that lives in the SDL library. which is to say — the code gets embedded straight into the calling program, and the linker and the dynamic loader will not be able to find this function inside SDL itself. it's giving "I live in your code now". 😭 so don't go looking for it in the library, she's not there, she's already home. 🫶

---

✨ FUNCTION PARAMETERS ✨

• a — the first rectangle you wanna test. 🍓
• b — the second rectangle you wanna test. 🌸

---

✨ RETURN VALUE ✨

returns true if the rectangles are equal, and false otherwise. that's it, that's the whole answer. ⭐

---

✨ THREAD SAFETY ✨

it is safe to call this function from any thread. go off, parallel besties. 🧚

---

✨ AVAILABILITY ✨

this function has been available since SDL 3.2.0. so if you're on anything older… girl. 👑

---

and that's the whole page, periodt. 💜

signing off from the Simple Directmedia Layer, running SDL 3.4.18 — stay iconic, keep your rects equal, and don't forget to check for NULL. mwah. 💖✨🎀