SDL_copysignf(3)

💖 SDL_copysignf(3) 💖

okay bestie, we're in the SDL3 FUNCTIONS section of the manual and today's main character is SDL_copysignf — she steals a sign from one float and hands it to another. no cap, that's the whole job. 🫶

---

✨ NAME ✨

SDL_copysignf — copy the sign of one floating-point value to another. literally just vibes transplant surgery. 💅

---

✨ SYNOPSIS ✨

#include <SDL3/SDL_stdinc.h>

float SDL_copysignf(float x, float y);

---

✨ DESCRIPTION ✨

so the official definition of copysign is giving:

copysign(x, y) = abs(x) * sign(y)

like, take the absolute value of x (strip her of her sign, tragic) and then multiply by the sign of y. that's it. that's the whole tea. 🍓

Domain: -INF <= x <= INF,

-INF <= y <= f

Range: -INF <= z <= INF

this one is the single-precision girlie — she works on single-precision floating point values only. if you need double-precision floats, go hang with SDL_copysign instead. don't mix them up, i'm begging. 😭

---

✨ FUNCTION PARAMETERS ✨

• x — floating point value to use as the magnitude. she's the how much, not the which way. 🌸
• y — floating point value to use as the sign. she's the which way, not the how much. ✨

---

✨ RETURN VALUE ✨

returns the floating point value with the sign of y and the magnitude of x. so like… a lil fusion dance of the two. iconic behavior honestly. 👑

---

✨ THREAD SAFETY ✨

it is safe to call this function from any thread. no locks, no drama, no gatekeeping — call her from wherever, whenever. 🧚

---

✨ AVAILABILITY ✨

this function is available since SDL 3.2.0. if your SDL is older than that, bestie… she simply does not exist for you yet. 🙈

---

✨ SEE ALSO ✨

• SDL_copysign(3) — the double-precision sister 💜
• SDL_fabsf(3) — if you only want the magnitude and not the sign handoff 🌈

---

okay that's the whole page, you ate that. go forth and copysign responsibly. 🎀

this lil love letter came to you from Simple Directmedia Layer, version SDL 3.4.18, and it's the SDL_copysignf(3) page itself — mwah, stay floaty. 💖🦋⭐