SDL_cos(3)

📦
version 3.4.18 · 9 versions
, in fedora 43, fedora 44

💖 SDL_cos 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, where we're gonna talk about SDL_cos — yes, the trigonometry girlies are THRIVING today 🎀

✨ NAME ✨

SDL_cos — compute the cosine of x. that's it. that's the whole job. and she does it flawlessly 💅

✨ SYNOPSIS ✨

#include <SDL3/SDL_stdinc.h>

double SDL_cos(double x);

like. look at her. so clean. so simple. no notes 👑

✨ DESCRIPTION ✨

okay so first things first, the domain and the range, because we respect boundaries in this house 🫶

  • Domain: -INF <= x <= INF
  • Range: -1 <= y <= 1

so like, you can throw literally any real number at her — even the absurdly huge ones — and she'll hand you back something cozy between -1 and 1. that's the vibe check. she always passes it. 😌

she operates on double-precision floating point values, so if you're out here working with single-precision floats, you want her sister SDL_cosf instead. iykyk ✨

🚨 okay important tea, do NOT skip this: this function may use a different approximation across different versions, platforms and configurations. meaning she can return a different value given the same input on different machines, different operating systems, or if SDL gets updated. so like… don't be out here comparing her results across devices expecting them to match exactly, because she said what she said 💀

✨ FUNCTION PARAMETERS ✨

  • x — a floating point value, in radians. (radians bestie, not degrees. i know. i know. we've all been there 🙈)

✨ RETURN VALUE ✨

she returns the cosine of x. that's the whole thing. no hidden surprises, no secret second return value, no plot twist. just cosine. iconic behavior honestly ⭐

✨ THREAD SAFETY ✨

it is safe to call this function from any thread. literally any of them. all your threads. simultaneously. she does not care, she does not fold under pressure, she is built different 🧚

✨ AVAILABILITY ✨

this function has been available since SDL 3.2.0. so if you're on anything older, bestie… it's giving not yet 😭

✨ SEE ALSO ✨

the whole trig friend group, obviously 💜

and that's the page!! 🦋 this little beauty comes to you courtesy of Simple Directmedia Layer, living her best life in SDL 3.4.18 🌸 go compute some cosines, bestie, you've got this. periodt. 💅✨

📦 where this page comes from