X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=Ada95%2Fhtml%2Fman%2Fcurs_initscr.3x.html;fp=Ada95%2Fhtml%2Fman%2Fcurs_initscr.3x.html;h=0000000000000000000000000000000000000000;hb=b1f61d9f3aa244512045a6b02e759825d7049d34;hp=38e367baa95c72a5dabe132fa7dc00a8579d1439;hpb=0eb88fc5281804773e2a0c7a488a4452463535ce;p=ncurses.git diff --git a/Ada95/html/man/curs_initscr.3x.html b/Ada95/html/man/curs_initscr.3x.html deleted file mode 100644 index 38e367ba..00000000 --- a/Ada95/html/man/curs_initscr.3x.html +++ /dev/null @@ -1,122 +0,0 @@ - -
-- initscr, newterm, endwin, isendwin, set_term, delscreen - - curses screen initialization and manipulation routines - - --
- #include-- - WINDOW *initscr(void); - int endwin(void); - int isendwin(void); - SCREEN *newterm(const char *type, FILE *outfd, FILE - *infd); - SCREEN *set_term(SCREEN *new); - void delscreen(SCREEN* sp); - - -
- initscr is normally the first curses routine to call when - initializing a program. A few special routines sometimes - need to be called before it; these are slk_init, filter, - ripoffline, use_env. For multiple-terminal applications, - newterm may be called before initscr. - - The initscr code determines the terminal type and initial- - izes all curses data structures. initscr also causes the - first call to refresh to clear the screen. If errors - occur, initscr writes an appropriate error message to - standard error and exits; otherwise, a pointer is returned - to stdscr. - - A program that outputs to more than one terminal should - use the newterm routine for each terminal instead of - initscr. A program that needs to inspect capabilities, so - it can continue to run in a line-oriented mode if the ter- - minal cannot support a screen-oriented program, would also - use newterm. The routine newterm should be called once - for each terminal. It returns a variable of type SCREEN * - which should be saved as a reference to that terminal. - The arguments are the type of the terminal to be used in - place of $TERM, a file pointer for output to the terminal, - and another file pointer for input from the terminal (if - type is NULL, $TERM will be used). The program must also - call endwin for each terminal being used before exiting - from curses. If newterm is called more than once for the - same terminal, the first terminal referred to must be the - last one for which endwin is called. - - A program should always call endwin before exiting or - escaping from curses mode temporarily. This routine - restores tty modes, moves the cursor to the lower left- - hand corner of the screen and resets the terminal into the - proper non-visual mode. Calling refresh or doupdate after - a temporary escape causes the program to resume visual - mode. - called without any subsequent calls to wrefresh, and FALSE - otherwise. - - The set_term routine is used to switch between different - terminals. The screen reference new becomes the new cur- - rent terminal. The previous terminal is returned by the - routine. This is the only routine which manipulates - SCREEN pointers; all other routines affect only the cur- - rent terminal. - - The delscreen routine frees storage associated with the - SCREEN data structure. The endwin routine does not do - this, so delscreen should be called after endwin if a par- - ticular SCREEN is no longer needed. - - --
- endwin returns the integer ERR upon failure and OK upon - successful completion. - - Routines that return pointers always return NULL on error. - - --
- Note that initscr and newterm may be macros. - - --
- These functions are described in the XSI Curses standard, - Issue 4. It specifies that portable applications must not - call initscr more than once. - - --
- curses(3X), curs_kernel(3X), curs_refresh(3X), - curs_slk(3X), curs_util(3X) - - - - - - - - - - - - - - - - - - - - -- -