std::fputws(3)

💖 std::fputws 💖

okay bestie, welcome to the std::fputws(3) page from the C++ Standard Libary — and yes, that's literally how the header spells “Library,” so we’re keeping it exactly as-is 😭💅. This function is giving wide-character output but make it a whole vibe, and we’re gonna get into every single detail. No cap.

🎀 NAME 🎀

std::fputws — std::fputws. That’s it. She’s concise, she’s iconic, she said “my name is my name” 💁‍♀️✨.

✨ Synopsis ✨

Defined in header <cwchar>:

int fputws( const wchar_t* str, std::FILE* stream );

So here’s the tea: std::fputws writes every wide character from the null-terminated wide string str to the output stream stream, as if by repeatedly executing std::fputwc. 🫶

And the important little detail: the terminating null wide character from str is not written. Not me being dramatic, that’s just the rule, bestie. 🚫

🌸 Parameters 🌸

• str — null-terminated wide string to be written.
• stream — output stream.

💜 Return value 💜

• On success, returns a non-negative value 🎉
• On failure, returns EOF and sets the error indicator (see std::ferror) on stream 😭

lowkey important: that failure case is not a vibe. Check the error indicator on stream if you get EOF.

🧚 Example 🧚

// Run this code

#include <clocale>
#include <cstdio>
#include <cwchar>

int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    int rc = std::fputws(L"御休みなさい", stdout);

    if (rc == EOF)
        std::perror("fputws()"); // POSIX requires that errno is set
}

🌈 Possible output 🌈

御休みなさい

👑 See also 👑

• fputs — writes a character string to a file stream (function)
• wprintf — prints formatted wide character output to stdout, a file stream or a buffer
• fwprintf — (function)
• swprintf
• fputws — writes a wide string to a file stream (function)
• fgetws — gets a wide string from a file stream (function)
• C documentation for fputws

xoxo, this std::fputws(3) page is from http://cppreference.com, version/date 2024.06.10 — bye bestie, go write some wide strings 💅🫶💖