Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
legacy_coding(3X)		 Library calls		     legacy_coding(3X)

NAME
       use_legacy_coding - override curses locale encoding checks

SYNOPSIS
       #include	<curses.h>

       int use_legacy_coding(int level);

DESCRIPTION
       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 charac-
       ters  to	 be  rendered  in  visible  form.  The alteration affects only
       eight-bit characters.

       The level parameter controls the	result.

	      0	   The library functions normally, rendering nonprinting char-
		   acters as described in unctrl(3X),

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

	      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,  use_legacy_coding  returns  ERR.  Otherwise,	it returns the
       previous	level: 0, 1, or	2.

PORTABILITY
       use_legacy_coding is specific to	ncurses.  It was not supported on Ver-
       sion 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).

SEE ALSO
       unctrl(3X)

ncurses	6.5			  2024-04-20		     legacy_coding(3X)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | PORTABILITY | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=legacy_coding&sektion=3&manpath=FreeBSD+14.2-RELEASE+and+Ports>

home | help