CLEANNAME(3)

💖 CLEANNAME(3) — from the Library Functions Manual — cleanname 💖

okay bestie, welcome to CLEANNAME(3), the page for cleanname, aka the little function that gives your path name a full lexical glow-up. no filesystem drama, just string vibes. periodt.

🌸 NAME 🌸

cleanname — clean a path name

✨ SYNOPSIS ✨

#include <u.h>
#include <libc.h>

char*     cleanname(char *filename)

🦋 DESCRIPTION 🦋

So cleanname takes a filename and — by lexical processing only, bestie, no cap — returns the shortest string that names the same (possibly hypothetical) file. It is not out here checking whether the file is real; it is literally just doing string surgery and serving.

It eliminates multiple and trailing slashes, and it lexically interprets . and .. directory components in the name. The string is overwritten in place.

The shortest string cleanname can return is two bytes: the null-terminated string ".". Therefore filename must contain room for at least two bytes.

🚨 bestie, this is the part where you pay attention: filename needs room for at least two bytes, because "." plus its null terminator is already two bytes. do not skimp on the buffer, i am begging.

🎀 SOURCE 🎀

/src/lib9/cleanname.c

🌈 SEE ALSO 🌈

cleanname(1)

and that’s the cute sign-off, bestie: CLEANNAME(3) — footer vibes only, mwah 💅💖✨