.\" Generated by the Allegro makedoc utility
.TH make_relative_filename 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
make_relative_filename \- Tries to make a relative filename from absolute path and filename. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B char *make_relative_filename(char *dest, const char *path, const char *filename, int size);
.SH 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:

.nf
   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 */
.fi
.SH "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:\\").

.SH SEE ALSO
.BR make_absolute_filename (3alleg4),
.BR is_relative_filename (3alleg4),
.BR canonicalize_filename (3alleg4)