X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Flegacy_coding.3x.html;h=d34697158bdd53a27eae69e067bde2c0564ca6c2;hp=6781399ab1c671c39a31f5ab47afb082a46daa8f;hb=HEAD;hpb=bca50d0d8592defee6c584fdedd25f4b1a31345b diff --git a/doc/html/man/legacy_coding.3x.html b/doc/html/man/legacy_coding.3x.html index 6781399a..29b42500 100644 --- a/doc/html/man/legacy_coding.3x.html +++ b/doc/html/man/legacy_coding.3x.html @@ -1,6 +1,7 @@ - -legacy_coding 3x - - +legacy_coding 3x 2024-04-20 ncurses 6.4 Library calls + + -

legacy_coding 3x

legacy_coding 3x 2024-04-20 ncurses 6.4 Library calls

-legacy_coding(3x)                                            legacy_coding(3x)
+legacy_coding(3x)                Library calls               legacy_coding(3x)

NAME

-       use_legacy_coding - override locale-encoding checks
+       use_legacy_coding - override curses locale encoding checks

SYNOPSIS

        #include <curses.h>
 
-       int use_legacy_coding(int level);
+       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.
+       use_legacy_coding is an extension to the curses library.  It allows the
+       caller to change the result of unctrl(3x), suppressing isprint(3)-based
+       checks  within  the  library  that  would  normally  cause  nonprinting
+       characters to be rendered in visible form.  The alteration affects only
+       eight-bit characters.
 
-       The level parameter controls the result:
+       The level parameter controls the result.
 
-              0    the library functions normally, rendering nonprinting char-
-                   acters as described in unctrl.
+              0    The   library  functions  normally,  rendering  nonprinting
+                   characters as described in unctrl(3x),
 
-              1    the  library  ignores  isprintf  for  codes  in  the  range
-                   160-255.
+              1    the library ignores isprint 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.
+              2    the library ignores isprint for codes in the range 128-255.
+                   It also modifies the output of unctrl(3x), 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.
+       If the screen has not been initialized, or the level parameter  is  out
+       of  range,  use_legacy_coding  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.
+       use_legacy_coding is specific to ncurses.   It  was  not  supported  on
+       Version  7,  BSD  or  System V implementations.  Applications employing
+       ncurses extensions should condition their use on the visibility of  the
+       NCURSES_VERSION preprocessor macro.
 
 
-

AUTHORS

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

AUTHOR

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