mvgetn_wstr man page on Tru64

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

curs_get_wstr(3)					      curs_get_wstr(3)

NAME
       curs_get_wstr,  get_wstr, getn_wstr, wget_wstr, wgetn_wstr, mvget_wstr,
       mvgetn_wstr, mvwget_wstr, mvwgetn_wstr - Get an array of	 wide  charac‐
       ters from a Curses terminal keyboard

SYNOPSIS
       #include <curses.h>

       int get_wstr(
	       wint_t *wstr ); int getn_wstr(
	       wint_t *wstr,
	       int n ); int wget_wstr(
	       WINDOW *win,
	       wint_t *wstr ); int wgetn_wstr(
	       WINDOW *win,
	       wint_t *wstr,
	       int n ); int mvget_wstr(
	       int y,
	       int x,
	       wint_t *wstr ); int mvgetn_wstr(
	       int y,
	       int x,
	       wint_t *wstr,
	       int n ); int mvwget_wstr(
	       WINDOW *win,
	       int y,
	       int x,
	       wint_t *wstr ); int mvwgetn_wstr(
	       WINDOW *win,
	       int y,
	       int x,
	       wint_t *wstr,
	       int n );

LIBRARY
       Curses Library (libcurses)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       get_wstr, getn_wstr, wget_wstr,	wgetn_wstr,  mvget_wstr,  mvgetn_wstr,
       mvwget_wstr, mvwgetn_wstr:  XCURSES4.2

       Refer  to  the  standards(5)  reference page for more information about
       industry standards and associated tags.

DESCRIPTION
       The effect of get_wstr is as though a series of calls to	 get_wch  were
       made,  until  a	newline, end-of-line, or end-of-file character is pro‐
       cessed. An end-of-file character is represented by WEOF, as defined  in
       <wchar.h>.  A  newline  or  end-of-line character is represented as its
       wchar_t value. In all instances, the end of the string is terminated by
       a null wchar_t. The routine places resulting values in the area pointed
       to by wstr. The routine's interpretation of the user's erase  and  kill
       characters affects the sequence of characters returned.

       The effect of wget_wstr is as though a series of calls to wget_wch were
       made.

       The effect of mvget_wstr is as though a call to move and then a	series
       of calls to get_wch were made.

       The  effect  of	mvwget_wstr  is	 as  though a call to wmove and then a
       series of calls to wget_wch were made.

       The getn_wstr, mvgetn_wstr, mvwgetn_wstr, and wgetn_wstr functions  are
       identical to the get_wstr, mvget_wstr, mvwget_wstr, and wget_wstr func‐
       tions, respectively, except that the *n_* versions read at most n char‐
       acters, letting the application prevent overflow of the input buffer.

NOTES
       Using  get_wstr,	 mvget_wstr,  mvwget_wstr, or wget_wstr to read a line
       that overflows the array pointed to by wstr causes  undefined  results.
       The use of getn_wstr, mvgetn_wstr, mvwgetn_wstr, or wgetn_wstr, respec‐
       tively, is recommended.

       These functions cannot return KEY_ values as there is no way to distin‐
       guish a KEY_ value from a valid wchar_t value.

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

       Note that all routines except wgetn_wstr may be macros.

RETURN VALUES
       All these functions return OK upon  successful  completion.  Otherwise,
       they return ERR.

SEE ALSO
       Functions: curses(3), curs_get_wch(3), curs_getstr(3)

       Others: standards(5)

							      curs_get_wstr(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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