aa_edit(3)

💖 aa_edit — the manual page, but make it cute 💖

ok so bestie, you're reading the aa_edit(3) page from the Library Functions Manual, and honestly? it's giving "tiny but mighty". let's get into it ✨

🌸 NAME 🌸

aa_edit — Simple interactive line editor. yes that's literally the whole vibe. a little line editor. a baby text box. iconic. 👑

✨ SYNOPSIS ✨

#include <aalib.h>

void aa_edit
(
     aa_context *c,
     int x,
     int y,
     int size,
     char *s,
     int maxsize
);

no cap, that's the whole signature. it returns void, so it's not gonna hand you a value back — it just does the thing. 🫶

🎀 PARAMETERS 🎀

okay so every single one of these matters, don't skip, i'm serious:

• aa_context *c — Specifies the AA-lib context to operate on. basically: which AA-lib world are we doing this in, bestie? that one. 🦋
• int x — X coordinate of the edited text. where the text sits horizontally, fr fr.
• int y — Y coordinate of the edited text. and where it sits vertically. the pair of them = the spot. 📍
• int size — Length of the editor window. how wide the lil editor box is.
• char *s — Buffer to edit (containing default value). yes it holds the default value, so you can pre-fill it and the user gets to mess with it. 💅
• int maxsize — Size of the buffer. this is the buffer's size, not the window's size — don't mix them up, i beg of you. 😭

💜 DESCRIPTION 💜

This function produces the simple interactive line editor that can be used by AA-lib programs to input strings.

that's it. that's the whole job. you want your AA-lib program to let a human type a string in? aa_edit is your girl. she shows up, she renders a lil interactive line editor, she lets the string get typed, periodt. ✨

🌈 SEE ALSO 🌈

the whole friend group, alphabetically-ish, no one left out, i would never:

save_d(3), mem_d(3), aa_help(3), aa_formats(3), aa_fonts(3), aa_dithernames(3), aa_drivers(3), aa_kbddrivers(3), aa_mousedrivers(3), aa_kbdrecommended(3), aa_mouserecommended(3), aa_displayrecommended(3), aa_defparams(3), aa_defrenderparams(3), aa_scrwidth(3), aa_scrheight(3), aa_mmwidth(3), aa_mmheight(3), aa_imgwidth(3), aa_imgheight(3), aa_image(3), aa_text(3), aa_attrs(3), aa_currentfont(3), aa_autoinit(3), aa_autoinitkbd(3), aa_autoinitmouse(3), aa_recommendhi(3), aa_recommendlow(3), aa_init(3), aa_initkbd(3), aa_initmouse(3), aa_close(3), aa_uninitkbd(3), aa_uninitmouse(3), aa_fastrender(3), aa_render(3), aa_puts(3), aa_printf(3), aa_gotoxy(3), aa_hidecursor(3), aa_showcursor(3), aa_getmouse(3), aa_hidemouse(3), aa_showmouse(3), aa_registerfont(3), aa_setsupported(3), aa_setfont(3), aa_getevent(3), aa_getkey(3), aa_resize(3), aa_resizehandler(3), aa_parseoptions(3), aa_createedit(3), aa_editkey(3), aa_putpixel(3), aa_recommendhikbd(3), aa_recommendlowkbd(3), aa_recommendhimouse(3), aa_recommendlowmouse(3), aa_recommendhidisplay(3), aa_recommendlowdisplay(3)

💖 that's the page!! go forth and edit some lines, you absolute main character 💖

this lil masterpiece came from c2man aalib.h and it's dated 8 September 1999 — yeah, vintage, and still slaying. 🎀🌸💅