XMTEXTFINDSTRINGWCS(3)

✨ NAME ✨

okay so bestie, welcome to the XmTextFindStringWcs page from the library call manual 💖 — this one is a Text function that finds the beginning position of a wide character text string. she's the wcs girlie of the XmText finder family, no cap 🦋

🌸 SYNOPSIS 🌸

#include <Xm/Text.h>
Boolean XmTextFindStringWcs(
Widget widget,
XmTextPosition start,
wchar_t *wcstring,
XmTextDirection direction,
XmTextPosition *position);

💅 DESCRIPTION 💅

XmTextFindStringWcs locates the beginning position of a specified wide character text string. this routine searches forward or backward for the first occurrence of the string, starting from the given start position. if a match is found, the function returns the position of the first character of the string in position. and the cute part? if the match string begins at the current position, this routine returns the current position. she's efficient like that ✨

• widget — specifies the Text widget ID 👑
• start — specifies the character position from which the search proceeds. this is an integer number of characters from the beginning of the text buffer. the first character position is 0 (zero). fr fr, zero-indexed, that's the vibe 🍓
• wcstring — specifies the wide character search string 🌈
• direction — indicates the search direction. it is relative to the primary direction of the text. the possible values are:
  • XmTEXT_FORWARD — the search proceeds toward the end of the buffer. main character energy, moving onward 💫
  • XmTEXT_BACKWARD — the search proceeds toward the beginning of the buffer. going back to her roots 🎀
• position — specifies the pointer in which the first character position of the string match is returned. this is an integer number of characters from the beginning of the buffer. the first character position is 0 (zero). if the function returns False, this value is undefined. 💀

not me reminding you that a False return means position is literally undefined — don't go reading it, bestie, that's giving undefined behaviour 🙈

for a complete definition of Text and its associated resources, see XmText(3).

🫶 RETURN 🫶

returns True if a string match is found; otherwise, returns False. slay or no slay, that's the whole deal ✨

💜 RELATED 💜

XmText(3) and XmTextFindString(3).

that's the whole page, bestie!! 🦋 this was XmTextFindStringWcs from the library call manual — no version or date info on this one, so just take the iconic manual name and go 💅🎀