getcchar(3X)                                                   getcchar(3X)

NAME
     getcchar - Einen Wide-Character-String mit Darstellung aus cchart
     abrufen

SYNTAX
     cc [flag ...] file ... -lcurses [library ...]

     #include <curses.h>

     int getcchar(const cchart *wcval, wchart *wch, attrt *attrs,
            short *colorpair, void *opts);

BESCHREIBUNG
     Wenn wch kein Null-Zeiger ist, extrahiert die Funktion getcchar()
     Informationen aus einem durch wcval definierten cchart, speichert die
     Zeichenattribute in das Objekt, auf das attrs zeigt, speichert das
     Farbpaar in das Objekt, auf das colorpair zeigt, und speichert den
     Wide-Character-String, auf den wcval verweist, in den Array, auf den
     wch zeigt.

     Wenn wch ein Null-Zeiger ist, ruft getcchar() die Anzahl der Wide-
     Characters aus dem Objekt ab, auf das wcval zeigt, und nimmt keine
     Änderungen an den Objekten vor, auf die attrs oder colorpair zeigen.

     Das Argument opts wird in einer späteren Ausgabe der vorliegenden
     Handbuchseite (Man Page) definiert. Derzeit muß die Anwendung für opts
     einen Null-Zeiger angeben.

RÜCKGABEWERT
     Wenn wch ein Null-Zeiger ist, gibt getcchar() die Anzahl der Wide-
     Characters zurück, auf die wcval verweist, einschließlich der Ende-
     null.

     Wenn wch kein Null-Zeiger ist, gibt getcchar() nach erfolgreicher Aus-
     führung den Wert OK zurück. Ansonsten wird ERR zurückgegeben.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Das Argument wcval kann ein Wert sein, der durch einen Aufruf von
     setcchar() oder durch eine Funktion generiert wurde, die ein Ausgabe-
     argument cchart aufweist. Wenn wcval auf andere Weise generiert
     wurde, ist das Ergebnis unbestimmt.

SIEHE AUCH
     attroff(3X), canchangecolor(3X), curses(3X), setcchar(3X),
     curses(5).







Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98