debian man page for make_relative_filename

Query: make_relative_filename

OS: debian

Section: 3alleg4

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
get_filename(3alleg4) - debian
ustrzcpy(3alleg4) - centos
ustrzcpy(3alleg4) - suse
get_filename(3alleg4) - netbsd
get_filename(3alleg4) - osx
Similar Topics in the Unix Linux Community
Extracting Filename from Fullpath
Help with Reg. Expression
Remove path from filename
Why does this SED example work?
Check dir for overly path+filename and list in txt