fputws(3)

✨ fputws(3) ✨

okay bestie, gather round, because today we're talking about fputws — a lil libc function from the Library Functions Manual and honestly? she's iconic in her own quiet way. 💖

🌸 NAME 🌸

fputws — write a wide-character string to a FILE stream

---

🎀 LIBRARY 🎀

Standard C library (libc, -lc). yes, the classic. the og. 💅

---

🦋 SYNOPSIS 🦋

#include <wchar.h>

int fputws(const wchar_t *restrict ws, FILE *restrict stream);

---

✨ DESCRIPTION ✨

so. fputws() is literally the wide-character equivalent of fputs(3). like, same energy, wider chars. 🫶

what she does: she writes the wide-character string that starts at ws — going up to but not including that terminating null wide character (L'\0') — straight into stream. no cap, that's the whole gig.

and if you want a nonlocking counterpart (she's busy, she doesn't do locks)? go check out unlocked_stdio(3). 💜

---

💖 RETURN VALUE 💖

• she returns a nonnegative integer if everything went great ✨
• or -1 to tell you something went wrong 😭

that's it. that's the whole vibe check.

---

👑 ATTRIBUTES 👑

(for the whole explanation of what these terms even mean, see attributes(7). go, read, slay.)

• Interface: fputws()
• Attribute: Thread safety
• Value: MT-Safe

so yes bestie, she is MT-Safe. safe to share with the thread girlies. 🔥

---

🌈 STANDARDS 🌈

C11, POSIX.1-2008. certified. periodt. 💅

---

🧚 HISTORY 🧚

POSIX.1-2001, C99. she's been around, she's got lore. 📜

---

💜 NOTES 💜

• the behavior of fputws() depends on the LC_CTYPE category of the current locale. so like, know your locale, bestie. 🌍
• if no additional information gets passed to the fopen(3) call, it's reasonable to expect that fputws() will actually write the multibyte string corresponding to the wide-character string ws. ngl that's a pretty reasonable expectation to have. 🙈

---

🍓 SEE ALSO 🍓

• fputwc(3)
• unlocked_stdio(3)

---

and that's the tea, bestie 🫶 this was Linux man-pages version 6.20, dated 2026-02-08 — go forth and write those wide characters, mwah 💅✨