curs_getcchar man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]

curs_getcchar(3X)				curs_getcchar(3X)

NAME
       getcchar,  setcchar - Get a wide character string and ren-
       dition from a cchar_t or set a cchar_t from a wide-charac-
       ter string

SYNOPSIS
       #include <curses.h>

       int getcchar(
	       const cchar_t *wcval,
	       wchar_t *wch,
	       attr_t *attrs,
	       short *color_pair,
	       void *opts );

       int setcchar(
	       cchar_t *wcval,
	       const wchar_t *wch,
	       const attr_t attrs,
	       short color_pair,
	       void *opts );

DESCRIPTION
       The  getcchar  function	gets  a wide-character string and
       rendition from a cchar_t argument.  When wch is not a null
       pointer, the getcchar function does the following:

       -    Extracts information from a cchar_t value wcval

       -    Stores  the	 character  attributes	in  the	 location
	    pointed to by attrs

       -    Stores the color-pair in the location pointed  to  by
	    color_pair

       -    Stores  the	 wide-character string, characters refer-
	    enced by wcval, into the array pointed to by wch.

       When wch is a null pointer, the getcchar function does the
       following:

       -    Obtains  the  number of wide characters pointed to by
	    wcval

       -    Does not change  the  data	referenced  by	attrs  or
	    color_pair

       The  setcchar function initializes the location pointed to
       by wcval by using:

       -    The character attributes in attrs

       -    The color pair in color_pair

       -    The wide-character string pointed  to  by  wch.   The
	    string  must be L'\0' terminated, contain at most one
	    character with strictly positive width, which must be
	    the	 first,	 and  contain  no  characters of negative
	    width.

NOTES
       The opts argument is reserved for future use.   Currently,
       an application must provide a null pointer as opts.

       The  wcval  argument may be a value generated by a call to
       setcchar or by a function that has a cchar_t output  argu-
       ment.   If  wcval  is  constructed by any other means, the
       effect is unspecified.

RETURN VALUES
       When wch is a null pointer, getcchar returns the number of
       wide  characters	 referenced  by wcval, including the null
       terminator.

       When wch is not a null pointer, getcchar returns	 OK  upon
       successful completion, and ERR otherwise.

       Upon  successful	 completion, setcchar returns OK.  Other-
       wise, it returns ERR.

SEE ALSO
       Functions:  curses(3X),	wcwidth(3X),   curs_attr_get(3X),
       can_change_color(3X).

						curs_getcchar(3X)
[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net