May 21, 2003 CURSES_ADDSTR 3

### NAME

curses_addstr, addstr, waddstr, addnstr, waddnstr, mvaddstr, mvwaddstr, mvaddnstr, mvwaddnstr - curses add character strings to windows routines

### LIBRARY

Curses Library (libcurses, -lcurses)

### SYNOPSIS

```int` addstr(```const char *string`)
```int` waddstr(```WINDOW *win``, const char *string`)
```int` mvaddstr(```int y``, int x``, const char *string`)
```int` mvwaddstr(```WINDOW *win``, int y``, int x``, const char *string`)
```int` addnstr(```const char *string``, int len`)
```int` waddnstr(```WINDOW *win``, const char *string``, int len`)
```int` mvaddnstr(```int y``, int x``, const char *string``, int len`)
```int` mvwaddnstr(```WINDOW *win``, int y``, int x``, const char *string``, int len`)

### DESCRIPTION

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

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

The addnstr(``) function will add the contents of ```string` to ```stdscr` but will limit the number of characters added to be, at most, ```len`. If ```len` is -1 then ```addnstr` will add the number of characters contained in the null terminated string ```string`. Any background attributes currently set on ```stdscr` will be applied to the added character. The waddnstr(``) function does the same as ```addnstr` but adds the string to the window specified by ```win`.

The functions mvaddstr(``), mwaddnstr(``), mvwaddstr(``) and mvwaddnstr(``) are the same as the functions addstr(``), waddstr(``), waddstr(``) and waddnstr(``), respectively, excepting 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

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_addchstr(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

The Curses package appeared in 4.0BSD.