.\" Generated by the Allegro makedoc utility
.TH uinsert 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
uinsert \- Inserts a character in a string. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B int uinsert(char *s, int index, int c);
.SH DESCRIPTION
Inserts the character `c' at the specified `index' in the string, sliding
the rest of the data along to make room. If `index' is negative, it counts
backward from the end of the string. Example:

.nf
   uinsert(text_string, 0, prefix_letter);
.fi
.SH "RETURN VALUE"
Returns the number of bytes by which the trailing part of the string was
moved.

.SH SEE ALSO
.BR uoffset (3alleg4),
.BR ugetat (3alleg4),
.BR usetat (3alleg4),
.BR uremove (3alleg4)