WCSRCHR(3POSIX)

📦 version 2017a, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

WCSRCHR 💖 (3POSIX)

okay bestie, so this one's from the POSIX Programmer's Manual — the whole shebang lives in section 3POSIX, and it's all about one lil' wide-character scanning function. pull up a chair 🫶

✨ PROLOG ✨

real talk before we start: this manual page is part of the POSIX Programmer's Manual. the Linux implementation of this interface may differ (so if you're on Linux, go check the corresponding Linux manual page for the actual tea ☕), or the interface might not even be implemented on Linux at all. 💀 not every system is gonna have it, iykyk.

🌸 NAME 🌸

wcsrchr — wide-character string scanning operation. yes queen, that's the whole name. short, sweet, iconic.

🎀 SYNOPSIS 🎀

#include <wchar.h>

wchar_t *wcsrchr(const wchar_t *ws, wchar_t wc);

like. look at her. so clean. 🦋

💅 DESCRIPTION 💅

bestie, quick heads up: the functionality described on this reference page is aligned with the ISO C standard. any conflict between what's written here and the ISO C standard is genuinely unintentional — no drama intended fr. this volume of POSIX.1‐2017 defers to the ISO C standard, periodt.

so what does wcsrchr() actually do?? it shall locate the last occurrence of wc in the wide-character string pointed to by ws. last, okay? not first. that's the whole vibe — it scans from the back, main character energy going backwards. 🔥

and here's the part you can't skip: the application shall ensure that the value of wc is a character representable as a type wchar_t and a wide-character code corresponding to a valid character in the current locale. no sneaking in random values, that's on you to guarantee. 🙈

also — and this is lowkey important — the terminating null wide-character code shall be considered to be part of the wide-character string. so it's in the club. it counts. 🎀

⭐ RETURN VALUE ⭐

upon successful completion, wcsrchr() shall return a pointer to the wide-character code — or a null pointer if wc does not occur in the wide-character string. that's it. that's the deal. if she's not there, you get a null pointer and you gotta handle that yourself bestie. 💀

🌈 ERRORS 🌈

no errors are defined. literally none. she's not like other functions. ✨

the following sections are informative — so like, they're the lore, not the law. 📖

💜 EXAMPLES 💜

None.

🧚 APPLICATION USAGE 🧚

None.

🍓 RATIONALE 🍓

None.

🦋 FUTURE DIRECTIONS 🦋

None.

👑 SEE ALSO 👑

  • wcschr() — the forward-scanning sibling, go say hi 💕
  • The Base Definitions volume of POSIX.1‐2017, <wchar.h>
Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .
Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

that's the whole page, bestie — every flag-free, option-free, error-free inch of it. 💅✨ stay scanning, queen. 🫶

IEEE/The Open Group • 2017 • WCSRCHR(3POSIX) — mwah, love u, bye 🎀💖

📦 where this page comes from