getn_wstr(3X)                                                 getn_wstr(3X)

NAME
     getnwstr, getwstr, mvgetnwstr, mvgetwstr, mvwgetnwstr,
     mvwgetwstr, wgetnwstr, wgetwstr - Einen Array aus Wide-Characters
     und Funktiontastencodes von einem Terminal abrufen

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

     #include <curses.h>

     int getnwstr(wchart *wstr, int n);

     int getwstr(wchart *wstr);

     int mvgetnwstr(int y, int x, wchart *wstr, int n);

     int mvgetwstr(int y, int x, wchart *wstr);

     int mvwgetnwstr(WINDOW *win, int y, int x, wchart *wstr, int n);

     int mvwgetwstr(WINDOW *win, int y, int x, wchart *wstr);

     int wgetnwstr(WINDOW *win, wchart *wstr, int n);

     int wgetwstr(WINDOW *win, wchart *wstr);

BESCHREIBUNG
     Das Ergebnis von getwstr() entspricht einer Reihe von getwch()-
     Aufrufen, die durchgeführt werden, bis ein Zeilenvorschubzeichen (New-
     line), ein Zeilenendezeichen oder ein Dateiendezeichen verarbeitet
     wird. Ein Dateiendezeichen wird durch WEOF, wie in <wchar.h> defi-
     niert, dargestellt. Ein Zeilenvorschub- oder Zeilenendezeichen wird
     wie der entsprechende wchart-Wert dargestellt. In allen Fällen wird
     das Ende des Strings durch ein Nullzeichen des Typs wchart darge-
     stellt. Die Ergebnisse werden in den Bereich gestellt, auf den wstr
     zeigt.

     Die Erase- und Kill-Zeichen des Benutzers werden interpretiert und
     wirken sich auf die Sequenz der zurückgegebenen Zeichen aus.

     Das Ergebnis von wgetwstr() entspricht einer Reihe von wgetwch()-
     Aufrufen.

     Das Ergebnis von mvgetwstr() entspricht einem Aufruf von move() mit
     anschließenden getwch()-Aufrufen. Das Ergebnis von mvwgetwstr() ent-
     spricht einem Aufruf von wmove() mit anschließenden wgetwch()-Auf-
     rufen. Das Ergebnis von mvgetnwstr() entspricht einem Aufruf von
     move() mit anschließenden getwch()-Aufrufen. Das Ergebnis von
     mvwgetnwstr() entspricht einem Aufruf von wmove() mit anschließenden
     wgetwch()-Aufrufen.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getn_wstr(3X)                                                 getn_wstr(3X)

     Die Funktionen getnwstr(), mvgetnwstr(), mvwgetnwstr() und
     wgetnwstr() lesen maximal n Zeichen und verhindern so einen möglichen
     Überlauf des Eingabepuffers.

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

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Wird mit getwstr(), mvgetwstr(), mvwgetwstr() oder wgetwstr() eine
     Zeile gelesen, die zu einem Überlauf des Array führt, auf den wstr
     zeigt, kommt es zu nicht definierten Ergebnissen. Hier wird die Ver-
     wendung der Funktionen getnwstr(), mvgetnwstr(), mvwgetnwstr() bzw.
     wgetnwstr() empfohlen.

     Diese Funktionen können keine KEY-Werte zurückgeben, da es keine Mög-
     lichkeit zur Unterscheidung eines KEY-Wertes von einem gültigen
     wchart-Wert gibt.

SIEHE AUCH
     curses(3X), getwch(3X), getstr(3X), curses(5), wchar(5).






























Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98