usetat(3alleg4)

📦 version 4.4.3.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

usetat(3alleg4) — bestie, this one replaces a character in a string, and it's from the Allegro game programming library. iconic behavior, no cap ✨

🌸 SYNOPSIS 🌸

#include <allegro.h>

int usetat(char *s, int index, int c);

🎀 DESCRIPTION 🎀

Okay so here's the tea: usetat replaces the character at the specified index in the string with value c. And because variable width data is extra like that, it handles any adjustments for it — ie. if c encodes to a different width than the previous value at that location, it deals with that too. flex, honestly 💅

If index is negative, it counts backward from the end of the string. walking backwards through the string like a true main character 🚶‍♀️✨

Example, bestie:

usetat(text_string, 2, letter_a);

💫 RETURN VALUE 💫

It returns the number of bytes by which the trailing part of the string was moved. byte movement math, but make it fashion 💃

This is of interest only with text encoding formats where characters have a variable length, like UTF-8. So if you're living that UTF-8 life, this is your moment 👀🔥

🦋 SEE ALSO 🦋

Allegro, version 4.4.3, and this whole page is the usetat(3alleg4) manual — slay, read, and go replace some characters responsibly 💖🎀✨

📦 where this page comes from