DtEditorFind(3)

DtEditorFind(3)	       C LIBRARY FUNCTIONS	  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, stop-
     ping 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), DtEditorIn-
     vokeFindChangeDialog(3).

Unix System LaboratoLast change: 1 August 1995			1