XmTextFindStringWcs(3X)

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

Showing IRIX 6.5.30 (default release). Added in IRIX 6.5.5.

     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);

     VERSION
          This page documents Motif 2.1.

     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).