GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MAKE_RELATIVE_FILENAME (3)

NAME

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

CONTENTS

Synopsis
Description
See Also

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(3), is_relative_filename(3), canonicalize_filename(3)
Search for    or go to Top of page |  Section 3 |  Main Index


Allegro MAKE_RELATIVE_FILENAME (3) version 4.4.2

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.