make_relative_filename(3alleg4) [debian man page]

make_relative_filename(3alleg4) 				  Allegro manual				   make_relative_filename(3alleg4)

NAME

       make_relative_filename - Tries to make a relative filename from absolute path and filename. Allegro game programming library.

SYNOPSIS

       #include <allegro.h>

       char *make_relative_filename(char *dest, const char *path, const char *filename, int size);

DESCRIPTION

       Attempts  to  make a relative filename from an absolute path and an absolute filename, storing at most `size' bytes into the `dest' buffer.
       This function won't work if the paths are not canonical under the current platform (see canonicalize_filename()). Also,	`dest'	cannot	be
       used as input value for `path' or `filename'. Example:

	  char base[] = "/long/absolute/path/program.exe";
	  char user_input[] = "/nice/and/short.txt";
	  ...
	  make_relative_filename(buf, base, user_input, sizeof(buf));
	  /* Under Unix buf would contain:
	     ../../../nice/and/short.txt */

RETURN VALUE

       Returns	a  copy  of  the  `dest'  parameter if it succeeds or NULL if it fails (eg. under DOS, one path starts with "C:" and another with
       "A:").

SEE ALSO

       make_absolute_filename(3alleg4), is_relative_filename(3alleg4), canonicalize_filename(3alleg4)

Allegro 							   version 4.4.2				   make_relative_filename(3alleg4)

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 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 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.2				    canonicalize_filename(3alleg4)