SDL_GetPathInfo(3)

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

💖 SDL_GetPathInfo(3) 💖

okay so bestie, welcome to the SDL3 FUNCTIONS corner of the manual, this one's called SDL_GetPathInfo and it's literally the "what even is this path" detector 🕵️♀️✨

🌸 NAME 🌸

SDL_GetPathInfo — get information about a filesystem path. that's it, that's the whole job, and she does it flawlessly 💅

✨ SYNOPSIS ✨

#include <SDL3/SDL_filesystem.h>

bool SDL_GetPathInfo(const char *path, SDL_PathInfo *info);

look at her. two args. returns a bool. iconic. 👑

🦋 DESCRIPTION 🦋

so here's the tea 🫖 — symlinks are ALWAYS followed on filesystems that support them. so you're never getting the info about the symlink itself, no ma'am, you get the info on whatever that symlink eventually points to. like, you asked about the girl and you got her whole friend group instead. no cap. 🎀

🧚 FUNCTION PARAMETERS 🧚

  • path — the path you wanna query. the one you're curious about. the main character of this operation. 🌟
  • info — a pointer that gets filled in with the info about the path. OR you can pass NULL — in which case it's just checking whether the file exists at all. lowkey a whole vibe check for your file. 💀

🌈 RETURN VALUE 🌈

returns true on success, or false if the file doesn't exist, or if some other failure happened (rude). when that happens, hit up SDL_GetError() for the deets, she'll tell you what went wrong. 😭

💜 THREAD SAFETY 💜

it is safe to call this function from any thread. go wild, gorl. multi-threaded queen behavior fr fr. 🧵✨

⭐ AVAILABILITY ⭐

this function has been available since SDL 3.2.0. so if you're on anything older... bestie. upgrade. 🙈

and that's the whole page, periodt 💖 this was written by the lovely folks at Simple Directmedia Layer, and it's page SDL_GetPathInfo(3) from SDL 3.4.18. mwah, go query some paths, you got this 🎀🫶🌸

📦 where this page comes from