SDL_NS_TO_MS(3)

✨ SDL_NS_TO_MS ✨

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual 💖 this one's called SDL_NS_TO_MS and she's a tiny little macro with a big job.

---

🌸 NAME 🌸

SDL_NS_TO_MS — convert nanoseconds to milliseconds. that's it. that's the whole girl. 💅

---

🎀 SYNOPSIS 🎀

#include <SDL3/SDL_timer.h>

#define SDL_NS_TO_MS(NS)        ((NS) / SDL_NS_PER_MS)

look at her 🦋 one #include, one #define, no drama.

---

💜 DESCRIPTION 💜

So basically, this macro does a division. simple right? NOT SO FAST 😭

The way that it's just (NS) / SDL_NS_PER_MS means the result can be dramatically different depending on whether NS is an integer or a floating point value. like, actually dramatically. not a little bit. dramatically. 👀

Integer division and floating point division are not the same vibe, and this macro does not care. it just divides. iykyk. 🙈

---

🧚 MACRO PARAMETERS 🧚

• NS — the number of nanoseconds you wanna convert, bb. that's the input. that's the whole input. 🌸

---

⭐ RETURN VALUE ⭐

Returns NS, expressed in milliseconds. 💖

she gives back what you gave her, just in a different unit. glow up. ✨

---

👑 THREAD SAFETY 👑

It is safe to call this macro from any thread. 🫶

no locks, no worries, no main character fights over shared state. every thread can have her. 💅

---

🌈 AVAILABILITY 🌈

This macro is available since SDL 3.2.0. so if you're on something older... bestie. upgrade. 😭

---

and that's the tea 🍓 go forth and convert your nanoseconds, you absolute icon. ⭐

mwah 💖 this page came to you from the Simple Directmedia Layer, running SDL 3.4.18, and yeah it's SDL_NS_TO_MS(3) — periodt. 💅✨