ustrncpy(3)

📦 version 4.4.3.1, in fedora 43, fedora 44

💖 ustrncpy 💖

okay so bestie, we're in the Allegro manual today and this one is ustrncpy from the Allegro game programming library. she copies a string into another one, but like, with a size limit. very demure, very mindful. ✨

🌸 SYNOPSIS 🌸

#include <allegro.h>

char *ustrncpy(char *dest, const char *src, int n);

🎀 DESCRIPTION 🎀

so literally, this function is ustrcpy() but with a vibe check on how much she's allowed to take. no more than n characters from src get copied into dest. that's it, that's the whole boundary. 💅

and here's the cute part — if src is shorter than n characters, she doesn't just leave dest hanging. she appends null characters to dest as padding until n characters have been written. filling in the gaps, being a supportive bestie, we love to see it. 🫶

⚠️ but bestie, listen. if src is longer than n characters, dest will not be null-terminated. no cap. she just stops writing and walks away, and if you were counting on that null terminator, that's on you. stay safe out there. 😭

⭐ RETURN VALUE ⭐

the return value is literally just the value of dest. that's it. she gives you back what you gave her. iconic behaviour honestly. 👑

🦋 SEE ALSO 🦋

and that's the whole page, bestie!! this one came from Allegro, version 4.4.3, and yeah the page is literally just called ustrncpy(3) again at the bottom because manpages love a little encore. 🎀✨ mwah, go write some strings safely, ily. 💖

📦 where this page comes from