NAME

       XmTextFindStringWcs  —  A  Text  function  that  finds  the  beginning  position of a wide
       character text string "XmTextFindStringWcs" "Text functions" "XmTextFindStringWcs"

SYNOPSIS

       #include <Xm/Text.h>
       Boolean XmTextFindStringWcs(
       Widget widget,
       XmTextPosition start,
       wchar_t *wcstring,
       XmTextDirection direction,
       XmTextPosition *position);

DESCRIPTION

       XmTextFindStringWcs locates the beginning position of  a  specified  wide  character  text
       string.  This routine searches forward or backward for the first occurrence of the string,
       starting from the given start position.  If a match is found,  the  function  returns  the
       position  of the first character of the string in position.  If the match string begins at
       the current position, this routine returns the current position.

       widget    Specifies the Text widget ID.

       start     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 (zero).

       wcstring  Specifies the wide character search string.

       direction Indicates the search direction. It is relative to the primary direction  of  the
                 text. The possible values are

                 XmTEXT_FORWARD
                           The search proceeds toward the end of the buffer.

                 XmTEXT_BACKWARD
                           The search proceeds toward the beginning of the buffer.

       position  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 (zero). If the function returns False,
                 this value is undefined.

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

RETURN

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

RELATED

       XmText(3) and XmTextFindString(3).

                                                                           XmTextFindStringWcs(3)