aa_createedit(3)

📦 version 1.4.0, in arch rolling, debian bookworm, debian trixie, epel 10, epel 9, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ aa_createedit ✨

okay so bestie, we're in the Library Functions Manual, section 3, and today's main character is aa_createedit. it's a lil helper function that hands you a simple interactive line editor for your AA-lib programs. yes, actual text input. in a text-mode graphics library. slay.

🎀 NAME 🎀

aa_createedit — the simple interactive line editor, served to you as a helper function. she's not doing too much, she's just here to help 💅

🦋 SYNOPSIS 🦋

#include <aalib.h>

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

🌸 PARAMETERS 🌸

  • aa_context *c — the AA-lib context you want to operate on. your whole vibe lives in here.
  • int x — X coordinate of the edited text. where horizontally she sits.
  • int y — Y coordinate of the edited text. where vertically she sits.
  • int size — length of the editor window. how much room she gets to stretch out.
  • char *s — the buffer to edit, and yes it comes with a default value already in it. she's pre-gamed 🍓
  • int maxsize — the size of that buffer. the hard ceiling, no going over it.

💅 DESCRIPTION 💅

so the way this works: you might use this function to input strings in your AA-lib programs. that's the whole assignment, and she ate.

this function initializes the aa_edit structure used by the event-based editor. think of it like setting the stage — she's not reading keys herself, she's just getting everything ready.

then, you might call the aa_editkey function when a key is pressed. that's the actual typing part. team effort, fr fr 🫶

✨ RETURNS ✨

pointer to the edit context when it's successful — and honestly the original manpage spells it "succesfull", which is iconic, we're keeping her energy 💖 — and NULL on failure. if you get NULL, that's a no. check your params.

lowkey important: NULL means failure. do not try to use it. not the moment.

🔥 SEE ALSO 🔥

the whole group chat, in order, because we don't skip anyone here:

🌈 the sign-off 🌈

this whole page was generated by c2man straight out of aalib.h, and it's dated 8 September 1999. yeah, she's vintage. a true OG. respect the elders, bestie 👑💜

that's the tea. go build something cute. ✨
📦 where this page comes from