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

FreeBSD Manual Pages

  
 
  

home | help
make_relative_filename(3)	Allegro	manual	     make_relative_filename(3)

NAME
       make_relative_filename  -  Tries	to make	a relative filename from abso-
       lute 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 abso-
       lute filename, storing at most `size' bytes  into  the  `dest'  buffer.
       This  function won't work if the	paths are not canonical	under the cur-
       rent 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(3),  is_relative_filename(3), canonicalize_file-
       name(3)

Allegro				 version 4.4.2	     make_relative_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=make_relative_filename&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help