iswpunct(3)

✨ iswpunct(3) ✨

okay bestie, so this is iswpunct(3) from the Library Functions Manual, and honestly? it's giving "tiny function, big personality" 💅 let's get into it.

🫶 NAME

iswpunct — the one that tests for a punctuation or symbolic wide character 💖

📚 LIBRARY

Standard C library (libc, -lc) 🎀

🌸 SYNOPSIS

#include <wctype.h>

int iswpunct(wint_t wc);

💫 DESCRIPTION

So iswpunct() is literally the wide-character equivalent of the ispunct(3) function, no cap. What it does is check whether wc is a wide character that belongs to the wide-character class "punct". that's it, that's the job 🦋

Now here's the lore, and it's actually kind of iconic:

• The wide-character class "punct" is a subclass of the wide-character class "graph", which means it's also a subclass of the wide-character class "print". nesting dolls fr fr 🪆
• The wide-character class "punct" is disjoint from the wide-character class "alnum" — and therefore also disjoint from all of its subclasses: "alpha", "upper", "lower", "digit", "xdigit". not overlapping, not even a little 🌈
• Because it's a subclass of "print", the "punct" class is disjoint from the "cntrl" class too ✨
• And because it's a subclass of "graph", "punct" is disjoint from "space" and its subclass "blank". bye bestie 💀

so basically: punctuation/symbols stay in their lane and everyone else stays in theirs. the vibe check is mutual and permanent 🎀

🔥 RETURN VALUE

• returns nonzero if wc is a wide character belonging to the wide-character class "punct" 👑
• otherwise, it returns zero 😔

💅 ATTRIBUTES

For the tea on what all these terms even mean, go peek at attributes(7). but here's the breakdown:

• iswpunct()
  • Attribute: Thread safety
  • Value: MT-Safe locale 🌟

📜 STANDARDS

C11, POSIX.1-2008. certified, standardized, slay ⭐

🕰️ HISTORY

POSIX.1-2001, C99. it's been around, it's got seniority 🧚

👀 NOTES

• The behavior of iswpunct() depends on the LC_CTYPE category of the current locale. so like, your locale is lowkey the main character here 🌍
• Okay so this one's important: this function's name is a misnomer when you're dealing with Unicode characters 😭 because the wide-character class "punct" contains both punctuation characters and symbol characters (math, currency, etc.). so the name says "punct" but it's actually doing punct + symbols. not me being deceived by a function name 🙈

---

🔗 SEE ALSO

• ispunct(3)
• iswctype(3)

---

💖 that's the whole page bestie, go forth and classify your wide characters responsibly 🫶

and that's a wrap on the Linux man-pages 6.20 page dated 2026-02-08 — this came straight from iswpunct(3) and she ate, periodt 💅✨🍓