Man Linux: Main Page and Category List

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)