XmTextFindString(3X)													      XmTextFindString(3X)

NAME

       XmTextFindString - A Text function that finds the beginning position of a text string

SYNOPSIS

       #include <Xm/Xm.h>

       Boolean XmTextFindString (widget, start, string, direction, position)
	       Widget widget;
	       XmTextPosition start;
	       char *string;
	       XmTextDirection direction;
	       XmTextPosition *position;

DESCRIPTION

       XmTextFindString locates the beginning position of a specified text string.  This routine searches forward or backward for the first occur-
       rence of the string starting from the given start position.  If it finds a match, the function returns the position of the first  character
       of  the	string	in  position.  Specifies the Text widget ID.  Specifies the character position from which the search proceeds.	This is an
       integer number of characters from the beginning of the text buffer.  The first character position  is  0.   Specifies  the  search  string.
       Indicates  the search direction.  It is relative to the primary direction of the text.  The possible values are: The search proceeds toward
       the end of the text buffer.  The search proceeds toward the beginning of the text buffer.  Specifies the pointer in which the first charac-
       ter position of the string match is returned.  This is an integer number of characters from the beginning of the buffer.  The first charac-
       ter position is 0.  If the function returns False, this value is undefined.

       For a complete definition of Text and its associated resources, see XmText(3X).

RETURN VALUE

       Returns True if a string match is found; otherwise, returns False.

SEE ALSO

       XmText(3X), XmTextFindStringWcs(3X)

															      XmTextFindString(3X)