개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

getnstr(3xcurses)

X/Open Curses Library Functions                              getnstr(3XCURSES)



NAME
       getnstr,  getstr, mvgetnstr, mvgetstr, mvwgetnstr, mvwgetstr, wgetnstr,
       wgetstr - get a multibyte character string from terminal

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

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

       #include <curses.h>

       int getnstr(char *str, int n);


       int getstr(char *str);


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


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


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


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


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


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

DESCRIPTION
       The getstr() and wgetstr() functions get a character  string  from  the
       terminal associated with the window stdscr or window win, respectively.
       The mvgetstr() and mvwgetstr() functions move the cursor to  the  posi‐
       tion  specified  in  stdscr  or win, respectively, then get a character
       string.


       These functions call wgetch(3XCURSES) and place each received character
       in  str  until  a newline is received, which is also placed in str. The
       erase and kill characters set by the user are processed.


       The getnstr(), mvgetnstr(), mvwgetnstr() and wgetnstr() functions  read
       at  most  n characters. These functions are used to prevent overflowing
       the input buffer.


       The getnstr(), wgetnstr(), mvgetnstr(), and mvwgetnstr() functions only
       return  complete multibyte characters. If the area pointed to by str is
       not large enough to hold at least one character, these functions fail.

PARAMETERS
       str    Is a pointer to the area where the character  string  is  to  be
              placed.


       n      Is the maximum number of characters to read from input.


       y      Is  the  y  (row)  coordinate  of starting position of character
              string to be read.


       x      Is the x (column) coordinate of starting position  of  character
              string to be read.


       win    Points to the window associated with the terminal from which the
              character is to be read.


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

ERRORS
       None.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _ Interface StabilityCommitted _ MT-LevelUnsafe _ Stan‐
       dardSee standards(7).


SEE ALSO
       getch(3XCURSES), libcurses(3XCURSES), attributes(7), standards(7)



Oracle Solaris 11.4               5 Jun 2002                 getnstr(3XCURSES)