May 21, 2003 CURSES_ADDCHSTR 3

### NAME

curses_addchstr, addchstr, waddchstr, addchnstr, waddchnstr, mvaddchstr, mvwaddchstr, mvaddchnstr, mvwaddchnstr - curses add character strings to windows routines

### LIBRARY

Curses Library (libcurses, -lcurses)

### SYNOPSIS

```int` addchstr(```const chtype *chstr`)
```int` waddchstr(```WINDOW *win``, const chtype *chstr`)
```int` mvaddchstr(```int y``, int x``, const chtype *chstr`)
```int` mvwaddchstr(```WINDOW *win``, int y``, int x``, const chtype *chstr`)
```int` addchnstr(```const chtype *chstr``, int n`)
```int` waddchnstr(```WINDOW *win``, const chtype *chstr``, int n`)
```int` mvaddchnstr(```int y``, int x``, const chtype *chstr``, int n`)
```int` mvwaddchnstr(```WINDOW *win``, int y``, int x``, const chtype *chstr``, int n`)

### DESCRIPTION

These functions add character strings and attributes to ```stdscr` or to the specified window.

The addchstr(``) function will add the characters and their attributes passed in ```chstr` to ```stdscr` starting at the current cursor position. Any character attributes set in ```chstr` will be merged with the background attributes currently set on ```stdscr`. The waddstr(``) function does the same as addchstr(``) but adds the string to the window specified by win(``).

The addchnstr(``) function will add the contents of ```string` to ```stdscr` but will limit the number of characters added to be, at most, ```n`. If ```n` is -1 then ```addchnstr` will add the number of characters contained in the null terminated string ```chstr`. Any character attributes set in ```chstr` will be merged with the background attributes currently set on ```stdscr`.

The waddchnstr(``) function does the same as ```addchnstr` but adds the string to the window specified by ```win`.

The functions mvaddchstr(``), mwaddchnstr(``), mvwaddchstr(``) and mvwaddchnstr(``) are the same as the functions addchstr(``), waddchstr(``), waddchstr(``) and waddchnstr(``), respectively, except that wmove(``) is called to move the cursor to the position specified by ```y`, ```x` before the string is added to the window.

### RETURN VALUES

The functions 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_addstr(3), curses_attributes(3), curses_cursor(3), curses_inch(3)

### STANDARDS

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

### HISTORY

These functions first appeared in NetBSD2.0.