SDL_randf_r(3)

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

✨ SDL_randf_r ✨

okay bestie, so this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_randf_r — she makes you a uniform pseudo-random floating point number that's less than 1.0. periodt. 💅

🌸 NAME 🌸

SDL_randf_r — generate a uniform pseudo-random floating point number less than 1.0 🎲

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_stdinc.h>

float SDL_randf_r(Uint64 *state);

🦋 DESCRIPTION 🦋

so like, if you want reproducible output, you literally have to initialize with SDL_srand() first. no cap. otherwise she's just doing her own thing. 🙈

and now for the vibe check: there are no guarantees as to the quality of the random sequence produced. ngl, this should not be used for security — like cryptography, passwords — or anywhere money is on the line (loot-boxes, casinos, bestie, think about the casino). there are so many random number libraries out there with all different characteristics, and you should pick one of those to meet any serious needs. this one's just here for the vibes, not the vault. 💀

💖 FUNCTION PARAMETERS 💖

  • state — a pointer to the current random number state. and hear me when i say this: this may not be NULL. not even a little. 🫶

⭐ RETURN VALUE ⭐

returns a random value in the range of [0.0, 1.0). slay. ✨

🌈 THREAD SAFETY 🌈

this function is thread-safe — as long as the state pointer isn't shared between threads. share the pointer, share the chaos. 👑

🧚 AVAILABILITY 🧚

this function is available since SDL 3.2.0. she's been here. 🌸

💜 SEE ALSO 💜

and that's the whole page, bestie!! 🎀 this little number lives in the Simple Directmedia Layer manual, version SDL 3.4.18, so if you ever forget where you found her, that's the receipt. bye bye, go make some random floats, ily 💖🦋

📦 where this page comes from