DtEditorFind(3) UNIX System V (1 August 1995) 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).
Page 1 (printed 9/3/04)