DTEDITORFIND(3)

💖 NAME 💖

okay bestie, this is DtEditorFind from the DtEditorFind(library call) manual — the icon whose whole job is searching for the next occurrence of a string in a DtEditor widget. It's giving text-search main character energy, no cap. 🦋

✨ SYNOPSIS ✨

#include &<Dt/Editor.h>
Boolean DtEditorFind(
       Widget widget,
       char *find);

🦋 DESCRIPTION 🦋

okay so here's the vibe: DtEditorFind searches for the next occurrence — relative to the insertion cursor — of a string. That string is either the last find string value specified in the Find/Change dialog (peep DtEditorInvokeFindChangeDialog(3), bestie) or it's passed in as an argument. 💅

• widget — specifies the DtEditor widget ID. That's the main character ID, periodt. 👑
• find — specifies the string to search for. If find is NULL, DtEditorFind uses the last string specified in the Find field of the Find/Change dialog. 🎀

If the string is not found by the time the end of the document is reached, the search continues at the beginning of the document, stopping at the character before the insertion cursor. yes, it heads back to the beginning — iconic behavior, but stay with me. 🔥

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). iykyk. 💜

💀 RETURN VALUE 💀

Upon successful completion, the DtEditorFind function returns True if the search string was found; otherwise, it returns False. That's it — found = True, not found = False, periodt. 💖

🌈 SEE ALSO 🌈

• Dt/Editor.h - DtEditor(5), DtEditor(3), DtEditorChange(3), DtEditorInvokeFindChangeDialog(3).

---

okay bestie, that's the whole page — signing off from the DtEditorFind(library call) footer energy. source/version/date weren't listed on this page, so this is the cute version instead: 🫶💖✨