WCSXFRM(3)

🌸 NAME 🌸

okay so bestie, this is the WCSXFRM(3) Library Functions Manual page, and the function is wcsxfrm — transform a wide string under locale 💅✨

🎀 LIBRARY 🎀

Standard C Library (libc, -lc) — that's the home base, periodt 🫶

🦋 SYNOPSIS 🦋

#include <wchar.h>

size_t
wcsxfrm(wchar_t * restrict dst, const wchar_t * restrict src, size_t n);

✨ DESCRIPTION ✨

The wcsxfrm() function transforms a null-terminated wide character string pointed to by src according to the current locale collation order then copies the transformed string into dst. No more than n wide characters are copied into dst, including the terminating null character added. If n is set to 0 (it helps to determine an actual size needed for transformation), dst is permitted to be a NULL pointer.

Comparing two strings using wcscmp() after wcsxfrm() is equivalent to comparing two original strings with wcscoll(). slay — that's literally the whole point, bestie 💖

💖 RETURN VALUES 💖

Upon successful completion, wcsxfrm() returns the length of the transformed string not including the terminating null character. If this value is n or more, the contents of dst are indeterminate.

okay warning, bestie: if that return value is n or more, the contents of dst are indeterminate — do not trust them, no cap 😭💀

🌈 SEE ALSO 🌈

• setlocale(3)
• strxfrm(3)
• wcscmp(3)
• wcscoll(3)

go read these too, iykyk 📚✨

⭐ STANDARDS ⭐

The wcsxfrm() function conforms to ISO/IEC 9899:1999 (“ISO C99”). iconic standardization moment ✨👑

💀 BUGS 💀

• The current implementation of wcsxfrm() only works in single-byte LC_CTYPE locales, and falls back to using wcsncpy() in locales with extended character sets.
• Comparing two strings using wcscmp() after wcsxfrm() is not always equivalent to comparison with wcscoll(); wcsxfrm() only stores information about primary collation weights into dst, whereas wcscoll() compares characters using both primary and secondary weights.

this is the tea, bestie — not always equivalent, and that's on primary vs secondary weights 🍓😭

---

okay that's the whole WCSXFRM(3) page, bestie 💖 this one's from Debian, dated October 4, 2002 — mwah 💋