# legacy_coding 3x

    legacy_coding(3x)                                     legacy_coding(3x)

## NAME

           use_legacy_coding - use terminal's default colors

## SYNOPSIS

           #include <curses.h>

           int use_legacy_coding(int level);

## DESCRIPTION

           The  use_legacy_coding()  function  is an extension to the
           curses library.  It allows the caller to change the result
           of  unctrl, and suppress related checks within the library
           that would normally cause  nonprinting  characters  to  be
           rendered in visible form.  This affects only 8-bit charac-
           ters.

           The level parameter controls the result:

                  0    the library functions normally, rendering non-
                       printing   characters  as  described  in  unc-
                       trl(3x).

                  1    the library ignores isprintf for codes in  the
                       range 160-255.

                  2    the  library ignores isprintf for codes in the
                       range 128-255.  It also modifies the output of
                       unctrl,  showing codes in the range 128-159 as
                       is.

## RETURN VALUE

           If the screen has  not  been  initialized,  or  the  level
           parameter is out of range, the function returns ERR.  Oth-
           erwise, it returns the previous level: 0, 1 or 2.

## PORTABILITY

           This routine is specific to ncurses.  It was not supported
           on Version 7, BSD or System V implementations.  It is rec-
           ommended that any code depending on ncurses extensions  be
           conditioned using NCURSES_VERSION.

## SEE ALSO

           unctrl.

## AUTHOR

           Thomas  Dickey (to support lynx's font-switching feature).

                                                          legacy_coding(3x)