Creates a new subwindow with numlines lines and numcols columns starting at the coordinates (begin_y,begin_x) on the terminal screen. Format #include <curses.h> WINDOW *subwin (WINDOW *win, int numlines, int numcols, int begin_y, int begin_x);
1 – Arguments
win A pointer to the parent window. numlines The number of lines in the subwindow. If numlines is 0, then the function sets that dimension to LINES - begin_y. To get a subwindow of dimensions LINES by COLS, use the following format: subwin (win, 0, 0, 0, 0) numcols The number of columns in the subwindow. If numcols is 0, then the function sets that dimension to COLS - begin_x. To get a subwindow of dimensions LINES by COLS, use the following format: subwin (win, 0, 0, 0, 0) begin_y A window coordinate at which the subwindow is to be created. begin_x A window coordinate at which the subwindow is to be created.
2 – Description
When creating the subwindow, begin_y and begin_x are relative to the entire terminal screen. If either numlines or numcols is 0, then the subwin function sets that dimension to (LINES - begin_y) or (COLS - begin_x), respectively. The window pointed to by win must be large enough to contain the entire area of the subwindow. Any changes made to either window within the coordinates of the subwindow appear on both windows.
3 – Return Values
window pointer A pointer to an instance of the structure window corresponding to the newly created subwindow. ERR Indicates an error.