replace_extension(3alleg)

replace_extension3alleg

Replaces filename+extension with a new extension tail. allegro game programming library.

Usage

#include <allegro.h>

char *replace_extension(char *dest, const char *filename, const char *ext, int size);

Overview

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:

   replace_extension(buf, "C:\\game\\prog.exe",
                     "dat", sizeof(buf));

Return value

Returns a copy of the `dest' parameter.

Releases

4 releases since Debian 3.1 (Sarge); the text changed 2 times.

  1. 3.1
  2. 4.0
  3. 5.0–6.0

From liballegro-doc 2:4.2.2-2.2 in Debian 6.0 (Squeeze). Parsed by carta from the page's man source.