NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

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

DESCRIPTION    [Toc]    [Back]

       XmTextFindString locates the beginning position of a specified
 text string.  This routine searches forward or backward
  for the first occurrence 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  character  position of the
       string match is returned.  This is an  integer  number  of
       characters  from  the  beginning of the buffer.  The first
       character 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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

       XmText(3X), XmTextFindStringWcs(3X)



                                             XmTextFindString(3X)