newwin

The newwin routine is used to create a window.

Syntax

   #include <curses.h>



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

Parameters

nlines: The number of lines in the new window.
ncols: The number of columns in the new window.
begin_y: The y (row) coordinate of the position of the upper left corner of window.
begin_x: The x (column) coordinate of the position of the upper left corner of the window.

Return Values

On success, pointer to new window structure is returned; otherwise, a null pointer is returned.

Description

The newwin() routine creates a new window with the specified number of lines and columns and upper left corner positioned at begin_x, begin_y. A pointer to the new window structure is returned. A full-screen window can be created by calling newwin(0,0,0,0).

If the number of lines specified is zero, newwin() uses the default LINES minus begin_y; if the number of columns specified is zero, newwin() uses the default COLS minus begin_x.




	NOTE: The `newwin()` routine is a macro.

Implementation Considerations

Identical to XPG/3

Portability

HP-UX, UNIX System V, XPG/3

newwin

Technical documentation

» Table of Contents

» Index