replace_filename(3alleg)

replace_filename3alleg

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

Usage

#include <allegro.h>

char *replace_filename(char *dest, const char *path, const char *filename, int size);

Overview

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:

   char name[200];
   ...
   get_executable_name(name, sizeof(name));
   replace_filename(name, name, "sound.dat", sizeof(name));

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.