FcDirCacheUnlink(3)

💅 FcDirCacheUnlink(3) — the fontconfig girlies' guide ✨

okay so this is a fontconfig manual page, section 3 (library functions, bestie 🫶), and it's literally about yeeting cache files. stay with me, it's short and it slaps.

---

🌸 NAME 🌸

FcDirCacheUnlink — remove all the caches related to dir 🧹✨

like, every single one. no crumbs left. periodt.

---

🦋 SYNOPSIS 🦋

#include <fontconfig/fontconfig.h>

FcBool FcDirCacheUnlink (const FcChar8 *dir, FcConfig *config);

---

💖 DESCRIPTION 💖

okay so the vibe is: it scans the cache directories in config 👀 and removes any instances of the cache file for dir. that's it, that's the whole function. she goes through config's cache dirs looking for the cache belonging to dir and just deletes them 💀

it returns FcFalse when some internal error occurs — like out of memory, etc. 😭 so like, the function itself being sad gives you a FcFalse.

but here's the key detail, and it's giving "we don't care energy": errors actually unlinking any files are ignored. 🫥 like if unlink() fails? not her problem. she said "i tried 💅" and moved on. the return value is not telling you about file-removal failures — only about internal errors.

ngl that last bit is the part people get wrong, so like, don't @ me when your files are still there and the return was FcTrue, iykyk.

---

🌈 a little recap for the girlies 🌈

• input dir → the directory whose caches get wiped 🎀
• input config → the config whose cache directories get scanned 🔍
• returns FcBool → FcFalse on internal errors (oom, etc), otherwise you're good ⭐
• unlink errors → ignored, no cap 🙈

---

👑 sign-off 👑

this iconic little page came to you from Fontconfig 2.17.0, dated 27 June 2025 💜 she's giving library-function realness, she's giving "delete the cache and don't stress", and honestly? obsessed. mwah 🎀🔥