.\" Generated by the Allegro makedoc utility
.TH replace_filename 3alleg4 "version 4.4.2" "Allegro" "Allegro manual"
.SH NAME
replace_filename \- Replaces path+filename with a new filename tail. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B char *replace_filename(char *dest, const char *path, 
.B const char *filename, int size);
.SH DESCRIPTION
Replaces the specified path+filename with a new filename tail, 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:

.nf
   char name[200];
   ...
   get_executable_name(name, sizeof(name));
   replace_filename(name, name, "sound.dat", sizeof(name));
.fi
.SH "RETURN VALUE"
Returns a copy of the `dest' parameter.

.SH SEE ALSO
.BR get_filename (3alleg4),
.BR replace_extension (3alleg4),
.BR append_filename (3alleg4)