Name

newwin − create new window

Syntax

#include <cursesX.h>

WINDOW ∗newwin(nlines, ncols, begin_y, begin_x)
int nlines, ncols, begin_y, begin_x;

Description

The function newwin creates a new window with the number of lines, nlines, and columns, ncols. The upper left corner of the window is at line begin_y, column begin_x.

If either nlines or ncols is zero, they will be defaulted to LINES - begin_y and COLS - begin_x. A new full-screen window is created by calling newwin(0,0,0,0).

Return Values

On success the newwin function returns a pointer to the new WINDOW structure created.  On failure the function returns a null pointer.