Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curs_inswstr(3CURSES)	   Curses Library Functions	 curs_inswstr(3CURSES)

NAME
       curs_inswstr,  inswstr, insnwstr, winswstr, winsnwstr, mvinswstr, mvin-
       snwstr, mvwinswstr, mvwinsnwstr - insert	wchar_t	string before  charac-
       ter under the cursor in a curses	window

SYNOPSIS
       cc [ flag ... ] file ...	-lcurses [ library .. ]
       #include	<curses.h>

       int inswstr(wchar_t *wstr);

       int insnwstr(wchar_t *wstr, int n);

       int winswstr(WINDOW *win, wchar_t *wstr);

       int winsnwstr(WINDOW *win, wchar_t *wstr, int n);

       int mvinswstr(int y, int	x, wchar_t *wstr);

       int mvinsnwstr(int y, int x, wchar_t *wstr, int n);

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

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

DESCRIPTION
       These  routines	insert	a   wchar_t character string (as many  wchar_t
       characters as will fit on the line) before the character	under the cur-
       sor.  All characters to the right of the	cursor are moved to the	right,
       with the	possibility of the rightmost  characters  on  the  line	 being
       lost.  The  cursor  position  does not change (after moving to y, x, if
       specified). (This does not imply	use of the hardware  insert  character
       feature.)  The four routines with n as the last argument	insert at most
       n wchar_t characters. If	n<=0, then the entire string is	inserted.

       If a character  in   wstr  is  a	 tab,  newline,	 carriage  return,  or
       backspace,  the cursor is moved appropriately within the	window.	A new-
       line also does a	 clrtoeol(3CURSES) before moving. Tabs are  considered
       to  be  at every	eighth column. If a character in  wstr is another con-
       trol character, it is drawn in the ^X notation. Calling winwch(3CURSES)
       after  adding a control character (and moving to	it, if necessary) does
       not return the control character, but instead returns  the  representa-
       tion of the control character.

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

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

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

NOTES
       The header file <curses.h>  automatically  includes  the	 header	 files
       <stdio.h>, <unctrl.h> and <widec.h>.

       Note that all but  winsnwstr() may be macros.

SunOS 5.10			  31 Dec 1996		 curs_inswstr(3CURSES)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=inswstr&sektion=3curses&manpath=SunOS+5.10>

home | help