Curses Library Functions                      cursinstr(3CURSES)



NAME
     cursinstr,  instr,  innstr,   winstr,   winnstr,   mvinstr,
     mvinnstr,  mvwinstr,  mvwinnstr - get a string of characters
     from a curses window

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     int instr(char *str);


     int innstr(char *str, int n);


     int winstr(WINDOW *win, char *str);


     int winnstr(WINDOW *win, char *str, int n);


     int mvinstr(int y, int x, char *str);


     int mvinnstr(int y, int x, char *str, int n);


     int mvwinstr(WINDOW *win, int y, int x, char *str);


     int mvwinnstr(WINDOW *win, int y, int x, char *str, int n);


DESCRIPTION
     These routines return a string of characters in str,  start-
     ing  at  the current cursor position in the named window and
     ending at the right margin of  the  window.  Attributes  are
     stripped  from  the characters. The four functions with n as
     the last argument return the string  at  most  n  characters
     long.

RETURN VALUES
     All routines return the integer  ER  upon  failure  and  an
     integer value other than ER upon successful completion.

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







SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                      cursinstr(3CURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that all routines except winnstr() may be macros.







































SunOS 5.11          Last change: 31 Dec 1996                    2