al_make_path_canonical(3)

🎀 NAME 🎀

Hii bestie, welcome to the al_make_path_canonical(3) page from the Library Functions Manual. The name tag is al_make_path_canonical — Allegro 5 API. That's it, that's the icon. 👑

✨ SYNOPSIS ✨

#include <allegro5/allegro.h>

bool al_make_path_canonical(ALLEGRO_PATH *path)

🦋 DESCRIPTION 🦋

Okay so al_make_path_canonical() is doing path cleanup, and it's very clear about what it will and won't touch. Here's the vibe:

• Removes any leading .. directory components in absolute paths. Leading parent-dir bits in absolute paths? Gone, bestie. 👋
• Removes all . directory components. Every single . component gets the boot. 💅

Note that this does not collapse x/../y sections into y. This is by design. If /foo on your system is a symlink to /bar/baz, then /foo/../quux is actually /bar/quux, not /quux as a naive removal of .. components would give you. That's intentional, not a glow-up fail — respect the symlink tea. 🫶

That's the al_make_path_canonical(3) tea, bestie — source: Allegro reference manual; version/date: not printed in the original footer, so no invented timestamp here, periodt. 💖✨