SHTK_FS_NORMALIZE_PATH(3)

🌸 NAME 🌸

Hiiii bestie 💖 this is SHTK_FS_NORMALIZE_PATH(3), a page straight out of the Library Functions Manual, and it's here to explain shtk_fs_normalize_path — the function that Returns a normalized form of a path. Slay. ✨

🎀 LIBRARY 🎀

You import it with:

shtk_import fs

⭐ SYNOPSIS ⭐

shtk_fs_normalize_path path

🦋 DESCRIPTION 🦋

Okay so shtk_fs_normalize_path takes the given path and prints its normalized form to stdout. That's the whole vibe. 💅

This process involves the following:

• Collapsing multiple consecutive forward slashes into one.
• Adding a . component at the beginning of the path if it is relative.
• Removing any . components, except for the first one.
• Removing any trailing slashes.

No cap, important caveat: the normalization happens without performing any file system operations. Therefore, it is perfectly possible for two normalized paths that look different to point to the same file system entry. In particular, this is because normalization does not take into account links nor .. components. 💀

💅 RETURN VALUES 💅

shtk_fs_normalize_path returns 0. Periodt. 🫶

🔥 EXAMPLES 🔥

These little glow-ups are everything:

shtk_fs_normalize_path /foo/bar  # Prints /foo/bar
shtk_fs_normalize_path foo/bar  # Prints ./foo/bar
shtk_fs_normalize_path foo///bar/./baz//  # Prints ./foo/bar/baz

🌈 SEE ALSO 🌈

shtk(3), shtk_fs(3) — go read those too, bestie 📚

👑 HISTORY 👑

shtk_fs_normalize_path first appeared in shtk 1.7. Iconic behavior since day one 💖

---

Source/version + date sign-off: this page is from Debian, dated September 18, 2016 — mwah, kisses 💋💅