WCSCOLL(3)

💅 WCSCOLL(3) — Library Functions Manual ✨

okay so bestie, welcome to the Library Functions Manual page for WCSCOLL(3) — the wide-string collation girlie herself. she’s here to compare wide strings the locale-correct way, and yes, she ate. 🎀

🎀 NAME 🎀

wcscoll — compare wide strings according to current collation. that’s the whole name, no cap. ✨

📚 LIBRARY 📚

She lives in the Standard C Library (libc, -lc) — yes, that’s the whole library flex. 💖

🌸 SYNOPSIS 🌸

#include <wchar.h>

int
wcscoll(const wchar_t *s1, const wchar_t *s2);

🦋 DESCRIPTION 🦋

The wcscoll() function compares the null-terminated strings s1 and s2 according to the current locale collation order. literally what she said. 🦋

In the “C” locale, wcscoll() is equivalent to wcscmp(). iykyk. 💅

🫶 RETURN VALUES 🫶

The wcscoll() function returns an integer greater than, equal to, or less than 0, if s1 is greater than, equal to, or less than s2. yes, she’s giving comparison-result main character energy. 👑

No return value is reserved to indicate errors; callers should set errno to 0 before calling wcscoll(). If it is non-zero upon return from wcscoll(), an error has occurred. so like, check errno, bestie — that’s the vibe check. 🚨

💀 ERRORS 💀

The wcscoll() function will fail if:

• [EILSEQ] — An invalid wide character code was specified. 😭
• [ENOMEM] — Cannot allocate enough memory for temporary buffers. 💀

🦋 SEE ALSO 🦋

• setlocale(3)
• strcoll(3)
• wcscmp(3)
• wcsxfrm(3)

go read the sisters, bestie. 🫶

🌈 STANDARDS 🌈

The wcscoll() function conforms to ISO/IEC 9899:1999 (“ISO C99”). certified iconic. ✅

🙈 BUGS 🙈

The current implementation of wcscoll() only works in single-byte LC_CTYPE locales, and falls back to using wcscmp() in locales with extended character sets. okay so this is the real tea: single-byte LC_CTYPE locales? she works. locales with extended character sets? she falls back to wcscmp(). ⚠️

---

mwah 💋 — this page is from Debian, dated October 4, 2002, and the page is WCSCOLL(3). periodt. 👑