mvins_nwstr man page on SmartOS

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

INS_NWSTR(3XCURSES)					   INS_NWSTR(3XCURSES)

NAME
       ins_nwstr,    ins_wstr,	  mvins_nwstr,	  mvins_wstr,	 mvwins_nwstr,
       mvwins_wstr, wins_nwstr, wins_wstr - insert a wide character string

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 ins_nwstr(const wchar_t *wstr, int n);

       int ins_wstr(const wchar_t *wstr);

       int mvins_nwstr(int y, int x, const wchar_t *wstr, int n);

       int mvins_wstr(int y, int x, const wchar_t *wstr);

       int mvwins_nwstr(WINDOW *win, int y, int x, const wchar_t *wstr, int n);

       int mvwins_wstr(WINDOW *win, int y, int x, const wchar_t *wstr);

       int wins_nwstr(WINDOW *win, const wchar_t *wstr, int n);

       int wins_wstr(WINDOW *win, const wchar_t *wstr);

PARAMETERS
       wstr
	       Is a pointer to the string to be inserted.

       n
	       Is the number of characters not to exceed when inserting	 wstr.
	       If n is less than 1, the entire string is inserted.

       y
	       Is  the	y  (row)  coordinate  of  the starting position of the
	       string.

       x
	       Is the x (column) coordinate of the starting  position  of  the
	       string.

       win
	       Is  a  pointer  to  the	window	in  which  the string is to be
	       inserted.

DESCRIPTION
       The ins_wstr() function inserts wstr at the current cursor position  of
       the  stdscr  window.  The  wins_wstr()  function performs the identical
       action, but in window  win.  The mvins_wstr() and  mvwins_wstr()	 func‐
       tions  insert  wstr  string at the starting position indicated by the x
       (column) and y  (row) parameters (the former in the stdscr window;  the
       latter in window win).

       The  ins_nwstr(), wins_nwstr(), mvins_nwstr(), and mvwins_nwstr() func‐
       tions insert n characters to the window or as many as will fit  on  the
       line.  If n is less than 1, the entire string is inserted or as much of
       it as  fits on the line.	 The former two functions place the string  at
       the  current cursor position; the  latter two commands use the position
       specified by the x and y parameters.

       All characters to the right of inserted characters  are	moved  to  the
       right.	Characters  that  don't fit on the current line are discarded.
       The cursor is left at the point of insertion.

       If a character in wstr is a newline,  carriage  return,	backspace,  or
       tab,  the  cursor  is  moved appropriately.  The cursor is moved to the
       next tab stop for each tab character (by default, tabs are eight	 char‐
       acters apart). If the character is a control character other than those
       previously mentioned, the character  is	inserted  using	 ^x  notation,
       where  x is a printable character.  clrtoeol(3XCURSES) is automatically
       done before a newline.

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
       add_wchnstr(3XCURSES),	  addnwstr(3XCURSES),	   clrtoeol(3XCURSES),
       ins_wch(3XCURSES),	 insnstr(3XCURSES),	  libcurses(3XCURSES),
       attributes(5), standards(5)

				  Jun 5, 2002		   INS_NWSTR(3XCURSES)
[top]

List of man pages available for SmartOS

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