GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CANONICALIZE_FILENAME (3)

NAME

canonicalize_filename - Converts any filename into its canonical form. Allegro game programming library.

CONTENTS

Synopsis
Description
See Also

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(3), fix_filename_slashes(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro CANONICALIZE_FILENAME (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.