canonicalize_filename

canonicalize_filename(3alleg4)   Allegro manual   canonicalize_filename(3alleg4)



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 absolute
       filename describing the same file and fixing incorrect forward/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
       canonicalize comes from another platform (eg. a "c:\something" path will
       canonicalize into something really wrong under Unix:
       "/current/path/c:/something").

RETURN VALUE
       Returns a copy of the `dest' parameter.


SEE ALSO
       fix_filename_case(3alleg4), fix_filename_slashes(3alleg4)



Allegro                           version 4.4.3   canonicalize_filename(3alleg4)