Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 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 ALSO
       fix_filename_case(3), fix_filename_slashes(3)

Allegro				 version 4.4.2	      canonicalize_filename(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=canonicalize_filename&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help