TICKIT_PEN_COPY(3)

💖 TICKIT_PEN_COPY 💖

okay bestie, welcome to TICKIT_PEN_COPY(3), from the Library Functions Manual ✨ this one's a two-for-one deal, no cap.

🎀 NAME 🎀

tickit_pen_copy, tickit_pen_copy_attr — copy attributes from one pen to another 💅

✨ SYNOPSIS ✨

#include <tickit.h>

void tickit_pen_copy(TickitPen *dst, TickitPen *src,
    bool overwrite);
void tickit_pen_copy_attr(TickitPen *dst, TickitPen *src,
    TickitPenAttr attr);

Link with -ltickit. 🫶

🌸 DESCRIPTION 🌸

so. tickit_pen_copy() copies all the attributes that are defined on src into dst. it's giving "closet cleanout but make it pens" 🧚

but here's the tea ☕ — if an attribute is already defined on dst, it only gets changed when overwrite is true. if overwrite is false, that existing value gets left tf alone. minding its own business. iconic behaviour honestly 💅

and bestie, it will invoke the TICKIT_EV_CHANGE event on the dst pen instance — but only if the value of at least one attribute has actually changed. no fake alarms, we don't do that here ✨

tickit_pen_copy_attr() is the single-serve version 🍓 it copies the value of one attribute from src into dst — or, plot twist, it clears it in dst if that attribute isn't present in src at all. and yeah, it will invoke the TICKIT_EV_CHANGE event on the dst pen instance. periodt. 💖

⭐ RETURN VALUE ⭐

ngl, tickit_pen_copy() and tickit_pen_copy_attr() return no value. void. nothing. empty-handed but thriving 🙈

🦋 SEE ALSO 🦋

• tickit_pen_new(3)
• tickit_pen_set_bool_attr(3)
• tickit_pen_set_int_attr(3)
• tickit_pen_set_colour_attr(3)
• tickit_pen_clear(3)
• tickit_pen(7)
• tickit(7)

k byeee, this was TICKIT_PEN_COPY(3) the whole time 👑 go copy some pens and slay 💜