Index for Section 3

Alphabetical listing for C

Bottom of page

curs_ins_wch(3)
NAME
  curs_ins_wch, ins_wch, wins_wch, mvins_wch, mvwins_wch - Insert a complex
  character and rendition before the character under the cursor in a Curses
  window

SYNOPSIS
  #include <curses.h>

  int ins_wch(
	  const cchar_t *wch );

  int wins_wch(
	  WINDOW *win,
	  const cchar_t *wch );

  int mvins_wch(
	  int y,
	  int x,
	  const cchar_t *wch );

  int mvwins_wch(
	  WINDOW *win,
	  int y,
	  int x,
	  const cchar_t *wch );

LIBRARY
  Curses Library (libcurses)

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  ins_wch, wins_wch, mvins_wch, mvwins_wch:  XCURSES4.2

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

DESCRIPTION
  These functions insert the complex character wch, along with its rendition,
  in the current or specified window at the current or specified cursor
  position. These functions:

    ·  Do not perform wrapping

       In other words, all characters to the right of the cursor are moved
       one space to the right, with the possibility of the rightmost
       character on the line being lost.

    ·  Do not change the cursor position after moving to y, x, if specified

       This does not imply use of the hardware insert-character feature.

    ·  Perform special-character processing

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

  Applications can use add_wch to add nonspacing characters to a spacing-
  complex character already in the window.

  Note that ins_wch, mvins_wch, and mvwins_wch may be macros.

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

SEE ALSO
  Functions: curses(3), curs_add_wch(3)

  Others: standards(5)

Index for Section 3

Alphabetical listing for C

Top of page