getstr man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

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, respec‐
       tively. The mvgetstr() and mvwgetstr() functions move the cursor to the
       position	 specified in stdscr or win, respectively, then get a  charac‐
       ter 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 posi‐
			       tion of	character string to be read.

       win		       Points to the window associated with the termi‐
			       nal 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(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

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

SunOS 5.10			  5 Jun 2002		     getnstr(3XCURSES)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net