CURSES_INSCH(3)

CURSES_INSCH(3) | Library Functions Manual | CURSES_INSCH(3)

# NAME

`curses_insch`, `insch`, `winsch`, `mvinsch`, `mvwinsch` —
curses insert characters routines

# LIBRARY

Curses Library (libcurses, -lcurses)

# SYNOPSIS

`#include <curses.h>`

int
`insch`(chtype ch);

int
`winsch`(WINDOW *win, chtype ch);

int
`mvinsch`(int y, int x, chtype ch);

int
`mvwinsch`(WINDOW *win, int y, int x, chtype ch);

# DESCRIPTION

These functions insert characters on `stdscr` or on the specified window.

The `insch`() function inserts the character given in ch at the current cursor position on `stdscr`. The cursor is not advanced and wrapping is not performed.

The `winsch`() function is the same as the `insch`() function, excepting that the character is inserted on the window specified by win.

The `mvinsch`() and `mvwinsch`() functions are the same as the `insch`() and `insch`() functions, respectively, excepting that `wmove`() is called to move the cursor to the position specified by y, x before the character is inserted on the window.

# RETURN VALUES

Functions returning pointers will return `NULL` if an error is detected. The functions that return an int will return one of the following values:

`OK`
  The function completed successfully.
`ERR`
  An error occurred in the function.

# SEE ALSO

curses_addch(3), curses_cursor(3), curses_delch(3)

# STANDARDS

The NetBSD Curses library complies with the X/Open Curses specification, part of the Single Unix Specification.

# HISTORY

The Curses package appeared in 4.0BSD.

October 25, 2018 | NetBSD 10.0