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

.sp
.B char *replace_extension(char *dest, const char *filename, 
.B const char *ext, int size);
.SH DESCRIPTION
Replaces the specified filename+extension with a new extension tail,
storing at most `size' bytes into the `dest' buffer. If the filename
doesn't have any extension at all, `ext' will be appended to it, adding
a dot character if needed. 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
   replace_extension(buf, "C:\\\\game\\\\prog.exe",
                     "dat", sizeof(buf));
.fi
.SH "RETURN VALUE"
Returns a copy of the `dest' parameter.

.SH SEE ALSO
.BR get_extension (3alleg4),
.BR replace_filename (3alleg4)