canonicalize_filename(3) Allegro manual canonicalize_filename(3)NAMEcanonicalize_filename - Converts any filename into its canonical form.
Allegro game programming library.
SYNOPSIS
#include <allegro.h>
char *canonicalize_filename(char *dest, const char *filename, int
size);
DESCRIPTION
Converts any filename into its canonical form, i.e. the minimal abso‐
lute filename describing the same file and fixing incorrect for‐
ward/backward slashes for the current platform, storing at most `size'
bytes into the `dest' buffer. You can use the same buffer both as input
and output because Allegro internally works on a copy of the input
before touching `dest'. Example:
char buf[256];
...
canonicalize_filename(buf, "~/../s22/..\\t3st///hi.c",
sizeof(buf));
/* Running this under Unix would
return: /home/t3st/hi.c */
Note that this function won't work as expected if the path to canoni‐
calize comes from another platform (eg. a "c:\something" path will
canonicalize into something really wrong under Unix: "/cur‐
rent/path/c:/something").
RETURN VALUE
Returns a copy of the `dest' parameter.
SEE ALSOfix_filename_case(3), fix_filename_slashes(3)Allegro version 4.4.2 canonicalize_filename(3)
