XmTextFindStringWcs(library call)            XmTextFindStringWcs(library call)

NAME
       XmTextFindStringWcs -- A Text function that finds the beginning
       position of a wide character text string

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(library call)