FreeBSD manual
download PDF document: use_legacy_coding.3.pdf
legacy_coding(3X) legacy_coding(3X)
NAME
use_legacy_coding - override locale-encoding checks
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
characters.
The level parameter controls the result:
0 the library functions normally, rendering nonprinting
characters as described in unctrl.
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. Otherwise, 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 recommended 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)