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 Committed MT-Level Unsafe Standard See standards(5).

See also

del_curterm(3XCURSES), initscr(3XCURSES), libcurses(3XCURSES), attributes(5), standards(5)