DtEditorFind(3)

     NAME
          DtEditorFind - search for the next occurrence of a string in
          a DtEditor widget

     SYNOPSIS
          #include <Dt/Editor.h>

          Boolean DtEditorFind(Widget widget,
                               char *find);

     DESCRIPTION
          The DtEditorFind() function searches for the next occurrence
          (relative to the insertion cursor) of a string.  The string
          is either the last find string value specified in the
          Find/Change dialog (see DtEditorInvokeFindChangeDialog(3))
          or is passed in as an argument.

          The widget argument specifies the DtEditor widget ID.

          The find argument 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.

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

     RETURN VALUE
          Upon successful completion, the DtEditorFind() function
          returns True if the search string was found; otherwise, it
          returns False.

     SEE ALSO
          DtEditor(5), DtEditor(3), DtEditorChange(3),
          DtEditorInvokeFindChangeDialog(3).