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(7) 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(7), standards(7)

June 5, 2002 USE_ENV(3XCURSES)