SDL_RemovePath(3)

💖 SDL_RemovePath 💖

okay bestie so real quick — this is a page from the SDL3 FUNCTIONS manual, and today's main character is SDL_RemovePath. she's simple, she's iconic, she deletes one (1) thing. let's get into it 🎀

---

✨ NAME ✨

SDL_RemovePath — Remove a file or an empty directory. that's it. that's the whole job. no cap. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_filesystem.h>

bool SDL_RemovePath(const char *path);

yes girl, one include, one function call, one bool. lowkey the cleanest API you'll ever meet 🫶

---

🦋 DESCRIPTION 🦋

So here's the tea, and it's important tea: directories that are not empty will fail. this function will not recursely delete directory trees. she is NOT out here bulldozing a whole folder of your stuff — she's removing one file, or one directory that's already empty. if there's anything still inside, she's gonna say no. 🙈

think of it like: she'll take the box out to the curb, but she will not go through the box for you. 📦

---

🎀 FUNCTION PARAMETERS 🎀

• path — the path to remove from the filesystem. literally just point at the thing and she'll yeet it (as long as it's a file or an empty directory, per above 💖).

---

⭐ RETURN VALUE ⭐

Returns true on success or false on failure — and if it's a false girlie, call SDL_GetError() for more information. she's not gonna leave you guessing, she'll tell you what went wrong 🌈

---

💜 THREAD SAFETY 💜

It is safe to call this function from any thread. go off, multithreaded queen 👑

---

🌟 AVAILABILITY 🌟

This function is available since SDL 3.2.0. so if you're on anything older, that's a no from her 💀

---

and that's the whole page, bestie — short, sweet, and fully aware of her limits. v important energy ngl.

made with love by the Simple Directmedia Layer girlies, version SDL 3.4.18, page SDL_RemovePath(3). mwah 💋✨