NAME¶
usetat - Replaces a character in a string. Allegro game programming library.
SYNOPSIS¶
#include <allegro.h>
int usetat(char *s, int index, int c);
DESCRIPTION¶
Replaces the character at the specified index in the string with value `c',
handling any adjustments for variable width data (ie. if `c' encodes to a
different width than the previous value at that location). If `index' is
negative, it counts backward from the end of the string. Example:
usetat(text_string, 2, letter_a);
RETURN VALUE¶
Returns the number of bytes by which the trailing part of the string was moved.
This is of interest only with text encoding formats where characters have a
variable length, like UTF-8.
SEE ALSO¶
uoffset(3alleg4), ugetat(3alleg4), uinsert(3alleg4),
uremove(3alleg4)
