X/Open Curses Library Functions                  inwch(3XCURSES)



NAME
     inwch, mvinwch, mvwinwch, winwch -  retrieve  a  complex
     character (with rendition)

SYNOPSIS
     cc [ flag... ] file... -I /usr/xpg4/include  -L  /usr/xpg4/lib \
      -R  /usr/xpg4/lib  -lcurses  [ library... ]

     c89 [ flag... ] file... -lcurses [ library... ]

     #include 

     int inwch(cchart *wcval);


     int mvinwch(int y, int x, cchart *wcval);


     int mvwinwch(WINDOW *win, inty, cchart *wcval);


     int winwch(WINDOW *win, cchart *wcval);


DESCRIPTION
     The inwch() and winwch() functions  retrieve  the  complex
     character  and  its  rendition located at the current cursor
     position of the  stdscr window and window win, respectively.
     The  mvinwch()  and mvwinwch() functions retrieve the com-
     plex character and its rendition  located  at  the  position
     indicated  by  the  x   (column) and y (row) parameters (the
     former in the stdscr window; the latter in window win).


     All these functions store the retrieved  character  and  its
     rendition in the  object pointed to by wcval.

PARAMETERS
     wcval    Is a pointer to an object that can store a  complex
              character and its rendition.


     y        Is the y (row) coordinate of the  position  of  the
              character to be returned.


     x        Is the x (column) coordinate of the position of the
              character to be returned.


     win      Is a pointer to the window that contains the  char-
              acter to be returned.



SunOS 5.11           Last change: 5 Jun 2002                    1






X/Open Curses Library Functions                  inwch(3XCURSES)



RETURN VALUES
     On success,  these  functions  return  OK.  Otherwise,  they
     return ER.

ERORS
     None.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Standard                    
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     addwch(3XCURSES),   inch(3XCURSES),    libcurses(3XCURSES),
     attributes(5), standards(5)






























SunOS 5.11           Last change: 5 Jun 2002                    2