dwww Home | Manual pages | Find package

legacy_coding(3NCURSES)                                legacy_coding(3NCURSES)

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  re-
       lated  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 char-
                   acters 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(3X).

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

                                                       legacy_coding(3NCURSES)

Generated by dwww version 1.15 on Wed Jun 26 18:14:11 CEST 2024.