FcConfigHome(3)

πŸ’– FcConfigHome(3) β€” your girl's guide to finding out where home is at 🏠✨

okay so real talk, this one's a tiny little fontconfig baddie and she's in section 3 of the manual, FcConfigHome(3) if you're keeping track, and honestly? she's short, she's sweet, she ate πŸ’…


🌸 NAME 🌸

FcConfigHome β€” returns the current home directory. that's it. that's the whole gig. no cap πŸŽ€


✨ SYNOPSIS ✨

#include <fontconfig/fontconfig.h>

FcChar8 * FcConfigHome (void);

look at her πŸ₯Ή no arguments, takes nothing, gives everything (well, gives you a pointer, which might be NULL, more on that in a sec bestie)


πŸ¦‹ DESCRIPTION πŸ¦‹

so here's the tea β˜• β€” FcConfigHome returns the current user's home directory, if it's available, and if using it is enabled. two vibe checks have to pass, basically:

  • is the home directory actually available? βœ…
  • is using it enabled? βœ…

if both of those are yes, you get the home directory. slay πŸŽ‰

and if not? it returns NULL. 😭 yep. NULL. so like, please check before you dereference, i'm literally begging 🫢

🚨 also peep: it says NULL otherwise, meaning anything that isn't "available AND enabled" = NULL. don't assume you're getting a path just because you asked nicely.

ooh and also β€” see also FcConfigEnableHome πŸ’œ (that's the one that handles the "is using it enabled" part of the equation, iykyk πŸ‘€). the original page has a lil stray ) hanging out at the end of that reference β€” she's iconic, we keep her, no notes πŸ’€


🌈 a lil sign-off 🌈

this page came from Fontconfig 2.17.0, dated 27 June 2025 β€” so like, if you're reading this in your terminal, that's the version and the date, periodt πŸ’…βœ¨ go forth and find your home directory, bestie πŸ πŸ’–

πŸ“¦ where this page comes from