NAME    [Toc]    [Back]

       curs_inwchstr, inwchstr, inwchnstr, winwchstr, winwchnstr,
       mvinwchstr, mvinwchnstr, mvwinwchstr, mvwinwchnstr - Get a
       string  of  wchar_t  characters  (and  attributes)  from a
       Curses window

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       int inwchstr(
               chtype *wchstr ); int inwchnstr(
               chtype *wchstr,
               int n ); int winwchstr(
               WINDOW *win,
               chtype *wchstr ); int winwchnstr(
               WINDOW *win,
               chtype *wchstr,
               int n ); int mvinwchstr(
               int y,
               int x,
               chtype *wchstr ); int mvinwchnstr(
               int y,
               int x,
               chtype *wchstr,
               int n ); int mvwinwchstr(
               WINDOW *win,
               int y,
               int x,
               chtype *wchstr ); int mvwinwchnstr(
               WINDOW *win,
               int y,
               int x,
               chtype *wchstr,
               int n );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

DESCRIPTION    [Toc]    [Back]

       These routines return a string  of  type  chtype,  holding
       wchar_t  characters,  starting at the current or specified
       cursor position in the current  or  specified  window  and
       ending at the right margin of the window.

       The four functions with n as the last argument, return the
       string at most n wchar_t characters long.

       Constants defined in <curses.h> can be  used  with  the  &
       (logical AND) operator to extract the wchar_t character or
       the attribute  alone  from  any  position  in  chstr  (see
       curs_inwch(3)).

NOTES    [Toc]    [Back]

       The  header  file  <curses.h>  automatically  includes the
       header file <stdio.h>.

       Note that all routines except winwchnstr may be macros.

       The routines described on this reference  page  are  among
       the  MNLS  Curses  functions  that are not included in the
       X/Open Curses CAE specification. MNLS  routines  are  supported
  only  for  backward compatibility reasons. Use the
       *in_wchstr and *in_wchnstr functions in  new  applications
       (see curs_in_wchstr(3)).

RETURN VALUES    [Toc]    [Back]

       All  routines  return  the integer ERR upon failure and an
       integer value other than ERR upon successful completion.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_in_wchstr, curs_inwch(3)



                                                 curs_inwchstr(3)