use_env(3XCURSES) X/Open Curses Library Functions use_env(3XCURSES)NAME
use_env - specify source of screen size information
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <curses.h>
void use_env(bool boolval);
PARAMETERS
boolval Is a Boolean expression.
DESCRIPTION
The use_env() function specifies the technique by which the implementation determines the size of the screen. If boolval is FALSE, the
implementation uses the values of lines and columns specified in the terminfo database. If boolval is TRUE, the implementation uses the
LINES and COLUMNS environmental variables. The initial value is TRUE.
Any call to use_env() must precede calls to initscr(3XCURSES), newterm(3XCURSES), or setupterm(3XCURSES).
RETURN VALUES
The use_env() function does not return a value.
ERRORS
No errors are defined.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard |
+-----------------------------+-----------------------------+
|MT-Level |Unsafe |
+-----------------------------+-----------------------------+
SEE ALSO del_curterm(3XCURSES), initscr(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)SunOS 5.10 5 Jun 2002 use_env(3XCURSES)
Check Out this Related Man Page
initscr(3XCURSES) X/Open Curses Library Functions initscr(3XCURSES)NAME
initscr, newterm - screen initialization functions
SYNOPSIS
cc [ flag... ] file... -I /usr/xpg4/include -L /usr/xpg4/lib
-R /usr/xpg4/lib -lcurses [ library... ]
c89 [ flag... ] file... -lcurses [ library... ]
#include <curses.h>
WINDOW *initscr(void);
SCREEN *newterm(char *type, FILE *outfp, FILE *infp);
PARAMETERS
type Is a string defining the terminal type to be used in place of TERM.
outfp Is a pointer to a file to be used for output to the terminal.
infp Is the pointer to a file to be used for input to the terminal.
DESCRIPTION
The initscr() function initializes X/Open Curses data structures, determines the terminal type, and ensures the first call to
refresh(3XCURSES) clears the screen.
The newterm() function opens a new terminal with each call. It should be used instead of initscr() when the program interacts with more
than one terminal. It returns a variable of type SCREEN, which should be used for later reference to that terminal. Before program termi-
nation, endwin() should be called for each terminal.
The only functions that you can call before calling initscr() or newterm() are filter(3XCURSES), ripoffline(3XCURSES), slk_init(3XCURSES),
and use_env(3XCURSES).
RETURN VALUES
On success, the initscr() function returns a pointer to stdscr; otherwise, initscr() does not return.
On success, the newterm() function returns a pointer to the specified terminal; otherwise, a null pointer is returned.
ERRORS
None.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard |
+-----------------------------+-----------------------------+
|MT-Level |Unsafe |
+-----------------------------+-----------------------------+
SEE ALSO del_curterm(3XCURSES), delscreen(3XCURSES), doupdate(3XCURSES), endwin(3XCURSES), filter(3XCURSES), libcurses(3XCURSES),
slk_attroff(3XCURSES), use_env(3XCURSES), attributes(5), standards(5)SunOS 5.10 5 Jun 2002 initscr(3XCURSES)