August 12, 2002 CURSES_PRINT 3

### NAME

curses_print, printw, wprintw, mvprintw, mvwprintw, unctrl - curses print formatted strings on windows routines

### LIBRARY

Curses Library (libcurses, -lcurses)

### SYNOPSIS

```int` printw(```const char *fmt``, ...`)
```int` wprintw(```WINDOW *win``, const char *fmt``, ...`)
```int` mvprintw(```int y``, int x``, const char *fmt``, ...`)
```int` mvwprintw(```WINDOW *win``, int y``, int x``, const char *fmt``, ...`)
```char``*` unctrl(```chtype ch`)

### DESCRIPTION

These functions print formatted strings on ```stdscr` or on the specified window.

The printw(``) function formats and prints its arguments on ```stdscr`. The behaviour is the same as that of printf(``).

The wprintw(``) function is the same as the printw(``) function, excepting that the resulting output is printed on the window specified by ```win`.

The mvprintw(``) and mvwprintw(``) functions are the same as the printw(``) and wprintw(``) functions, respectively, excepting that wmove(``) is called to move the cursor to the position specified by ```y`, ```x` before the output is printed on the window.

The unctrl(``) function returns a printable string representation of the character ```ch`. If ```ch` is a control character then it will be converted to the form ^Y.

### 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_cursor(3), curses_scanw(3), printf(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.