assign(3)

assign(3) — from the Library Functions Manual 💖

okay bestie, welcome to the assign(3) page, and no cap, this one is a tiny little macro with main character energy. It's giving "assign an integer value, check for truncation" and honestly? iconic.

✨ NAME ✨

assign — assign an integer value, check for truncation 🎀

🛠 SYNTAX 🛠

#include <libowfat/rangecheck.h>

int assign(dest,a);

That's the whole synopsis, bestie. The include is libowfat/rangecheck.h, and the call looks like int assign(dest,a);. Keep it exact, no edits. 💅

📝 DESCRIPTION 📝

Okay so here's the tea. If a and dest have the same type, OR if the value of a is representable in the type of dest, then you do dest=a and it returns 0. Slay. That's the success path. ✨

Otherwise, it returns 1. That's the "nope, not happening" path. 😭

Note: This is a macro, so dest does not have to be a pointer. Don't come for me, that's literally what the page says. 💅

🐛 BUGS 🐛

Not a bug exactly, but a little chaos you need to know: in the multiplication functions, a return value of 1 signals success and 0 means failure. But in add_of, sub_of and assign, it's the other way around. So 0 is success and 1 is failure. Yes, it's giving inconsistent, and yes, you're valid for being confused. 🙈

👀 SEE ALSO 👀

• add_of(3)
• sub_of(3)
• imult16(3)
• umult16(3)
• imult32(3)
• umult32(3)
• imult64(3)
• umult64(3)

signed off from the Library Functions Manual, page assign(3) — the footer doesn't give a version or date, just the page name, so this is the whole vibe 💖💅 periodt