addchstr(3X)                                                   addchstr(3X)

NAME
     addchstr, addchnstr, mvaddchstr, mvaddchnstr, mvwaddchstr,
     mvwaddchnstr, waddchstr, waddchnstr - String aus Einzelbytezeichen und
     Darstellungen in ein Fenster einfügen

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

     #include <curses.h>

     int addchstr(const chtype *chstr);

     int addchnstr(const chtype *chstr, int n);

     int mvaddchstr(int y, int x, const chtype *chstr);

     int mvaddchnstr(int y, int x, const chtype *chstr, int n);

     int mvwaddchstr(WINDOW *win, int y, int x, const chtype *chstr);

     int mvwaddchnstr(WINDOW *win, int y, int x, const chtype *chstr,
              int n);

     int waddchstr(WINDOW *win, const chtype *chstr);

     int waddchnstr(WINDOW *win, const chtype *chstr, int n);

BESCHREIBUNG
     Bei diesen Funktionen wird der Inhalt des aktuellen oder angegebenen
     Fensters beginnend bei der aktuellen oder angegebenen Position durch
     den Inhalt des Arrays überlagert, auf das chstr zeigt, bis in diesem
     Array ein chtype von Null gefunden wird.

     Bei diesen Funktionen ändert sich die Cursor-Position nicht. Die Funk-
     tionen verarbeiten keine Sonderzeichen und es werden keine Zeilenum-
     brüche durchgeführt.

     Die Funktionen addchnstr(), mvaddchnstr(), mvwaddchnstr() und
     waddchnstr() kopieren maximal n Elemente aus dem String. Dabei werden
     jedoch nur so viele Elemente kopiert, wie in die aktuelle oder angege-
     bene Zeile passen. Wenn n gleich -1 ist, wird der gesamte String
     kopiert, bis die maximale Anzahl der in die Zeile passenden Elemente
     erreicht ist.

RÜCKGABEWERT
     Diese Funktionen geben bei erfolgreicher Ausführung den Wert OK
     zurück. Andernfalls wird der Wert ERR zurückgegeben.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

addchstr(3X)                                                   addchstr(3X)

HINWEISE
     Eine einwandfreie Ausführung dieser Funktionen ist nur bei Zeichensät-
     zen garantiert, bei denen jedes Zeichen, dessen Attribute durch die
     alleinige Verwendung von Konstanten mit dem Präfix A ausgedrückt wer-
     den können, in ein Einzelbyte paßt.

SIEHE AUCH
     addch(3X), addwch(3X), addwchstr(3X), curses(3X), curses(5).














































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98