DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

getcchar(CURSES)


getcchar -- get a wide character string and rendition from a cchar_t

Synopsis

cc [options] file -lcurses
#include <curses.h>

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

Description

When wch is not a null pointer, the getcchar(CURSES) function extracts information from a cchar_t defined by wcval, stores the character attributes in the object pointed to by attrs, stores the colour pair in the object pointed to by color_pair, and stores the wide character string referenced by wcval into the array pointed to by wch.

When wch is a null pointer, getcchar(CURSES) obtains the number of wide characters in the object pointed to by wcval and does not change the objects pointed to by attrs or color_pair.

The opts argument is reserved for definition in a future edition of this document. Currently, the application must provide a null pointer as opts.

Return value

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

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

Errors

No errors are defined.

Usage

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

Standards Conformance

The Single UNIX Specification, Version 2; The Open Group.

References

attroff(CURSES), can_change_color(CURSES), setcchar(CURSES), curses(F)
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 - 01 June 2005