XMTEXTFINDSTRING(3)

✨ NAME ✨

okay so bestie, this is XmTextFindString — a Text function that finds the beginning position of a text string 💖 it's giving "where in this whole buffer does my lil string start", and honestly? iconic.

🎀 SYNOPSIS 🎀

#include <Xm/Xm.h>
Boolean XmTextFindString(
Widget widget,
XmTextPosition start,
char *string,
XmTextDirection direction,
XmTextPosition *position);

💅 DESCRIPTION 💅

XmTextFindString locates the beginning position of a specified text string. no cap, that's the whole job 🫶

This routine searches forward or backward for the first occurrence of the string, starting from the given start position. If it finds a match, the function returns the position of the first character of the string in position. and here's a lil detail that lowkey matters: if the match string begins at the current position, this routine returns the current position. like, yes, right where you're standing counts 💀

• widget — Specifies the Text widget ID. that's your main character, the Text widget in question 👑
• 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). zero-indexed, as the ancients intended ✨
• string — Specifies the search string. the thing you're hunting for 🔍
• 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 text buffer. going forward bestie, onwards and upwards 🌈
  • XmTEXT_BACKWARD — The search proceeds toward the beginning of the text buffer. rewinding, scrolling back, nostalgic vibe 🦋
• 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.

🚨 bestie listen — if the function returns False, position is undefined. don't be out here reading it anyway. that's not a vibe, that's undefined behavior territory 💀

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. found it = True, no luck = False, periodt 💅

🧚 RELATED 🧚

• XmText(3)
• XmTextFindStringWcs(3)

okay that's the whole page, we ate and left no crumbs 🍓 this was XmTextFindString(library call) — yes the manpage footer literally just says the same thing again, the library call title, cute of it, love that for us 💜 go forth and find your strings, bestie 💖