DTEDITORCHANGE(3)

📦
version 2.5.3 · 2 versions
, in nixos 26.05

DtEditorChange 💅

okay so this is a library call — that’s the manual name, bestie, DtEditorChange(library call) energy — and it’s literally all about changing strings inside a DtEditor widget. no cap, she’s iconic ✨

✨ NAME ✨

DtEditorChange — change one or all occurrences of a string in a DtEditor widget 🌸

🌸 SYNOPSIS 🌸

#include &<Dt/Editor.h>
Boolean DtEditorChange(
Widget widget,
DtEditorChangeValues *findChangeStrings,
unsigned int instanceToChange);

💖 DESCRIPTION 💖

DtEditorChange swaps out the next occurrence of a string, all occurrences of the string, or the currently selected text in a DtEditor widget with a replacement string. The string to search for and the value to change it to can be the last values entered in the Find/Change dialog (peep DtEditorInvokeFindChangeDialog(3)) or passed as arguments to DtEditorChange.

The search starts at the insertion cursor. If the string isn’t 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. It’s giving wrap-around hunt, and honestly? Obsessed. 🎀

widget is the DtEditor widget ID — that’s your main character widget. findChangeStrings is the string to change plus the replacement value. If findChangeStrings is NULL, DtEditorChange uses the last string specified in the Find and Change To fields of the Find/Change dialog. And if instanceToChange is DtEDITOR_CURRENT_SELECTION, the Find field of DtEditorChangeValues is ignored. Yes, the manpage says that ignored-Find-field thing twice — it’s clearly a big deal 💅

instanceToChange is the switch that decides the vibe:

  • DtEDITOR_NEXT_OCCURRENCE — replaces the next occurrence (relative to the insertion cursor) of the find string.
  • DtEDITOR_ALL_OCCURRENCES — changes all instances of the find string.
  • DtEDITOR_CURRENT_SELECTION — the Find field of DtEditorChangeValues is ignored, and the currently selected text is replaced.

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). For a complete definition of DtEditorChangeValues, see Dt/Editor.h - DtEditor(5).

🎀 RETURN VALUE 🎀

Upon successful completion, DtEditorChange returns True if the substitution occurred; otherwise, it returns False. Binary slay — yes or no, no maybes ✨

🦋 SEE ALSO 🦋

— source/version: DtEditorChange(library call); date: not listed in this footer, and honestly she’s timeless. bye bestie 🫶💜

📦 where this page comes from