FreeBSD Manual Pages
canonicalize_filename(3) Allegro manual canonicalize_filename(3) NAME canonicalize_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 ab- solute 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 be- fore 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 ALSO fix_filename_case(3), fix_filename_slashes(3) Allegro version 4.4.3 canonicalize_filename(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=canonicalize_filename&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>