getnstr(3X)                                                     getnstr(3X)

NAME
     getnstr, getstr, mvgetnstr, mvgetstr, mvwgetnstr, mvwgetstr, wgetstr,
     wgetnstr - Einen Mehrbytezeichen-String vom Terminal abrufen

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

     #include <curses.h>

     int getnstr(char *str, int n);

     int getstr(char *str);

     int mvgetnstr(int y, int x, char *str, int n);

     int mvgetstr(int y, int x, char *str);

     int mvwgetnstr(WINDOW *win, int y, int x, char *str, int n);

     int mvwgetstr(WINDOW *win, int y, int x, char *str);

     int wgetnstr(WINDOW *win, char *str, int n);

     int wgetstr(WINDOW *win, char *str);

BESCHREIBUNG
     Das Ergebnis von getstr() entspricht einer Reihe von getch()-Aufrufen,
     die durchgeführt werden, bis ein Zeilenvorschub, ein Carriage Return
     oder das Dateiende erreicht wird. Das Ergebnis wird in den Bereich
     gestellt, auf den str zeigt. Anschließend wird der String mit einem
     Nullbyte abgeschlossen. Die Funktionen getnstr(), mvgetnstr(),
     mvwgetnstr() und wgetnstr() lesen maximal n Zeichen und verhindert so
     einen möglichen Überlauf des Eingabepuffers. Sowohl die Erase- und
     Kill-Zeichen des Benutzers als auch alle Sondertasten (wie Funktions-
     tasten, die HOME-Taste oder Löschen-Taste (Clear)) werden interpre-
     tiert.

     Das Ergebnis der Funktion mvgetstr() entspricht einem Aufruf von
     move() mit anschließenden getch()-Aufrufen; ansonsten ist die Funktion
     mit der Funktion getstr() identisch. Das Ergebnis der Funktion
     mvwgetstr() entspricht einem Aufruf von wmove() mit anschließenden
     wgetch()-Aufrufen; ansonsten ist die Funktion mit der Funktion
     getstr() identisch. Das Ergebnis der Funktion mvgetnstr() entspricht
     einem Aufruf von move() mit anschließenden getch()-Aufrufen; ansonsten
     ist die Funktion mit der Funktion getnstr() identisch. Das Ergebnis
     der Funktion mvwgetnstr() entspricht einem Aufruf von wmove() mit
     anschließenden wgetch()-Aufrufen; ansonsten ist die Funktion mit der
     Funktion getnstr() identisch.







Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

getnstr(3X)                                                     getnstr(3X)

     Die Funktionen getnstr(), wgetnstr(), mvgetnstr() und mvwgetnstr()
     geben nur die gesamte, einem Zeichen zugeordnete Mehrbytesequenz
     zurück. Wenn der Array groß genug ist, um zumindest ein Zeichen aufzu-
     nehmen, füllt die Funktion den Array mit vollständigen Zeichen auf.
     Wenn der Array zur Aufnahme eines vollständigen Zeichens nicht aus-
     reicht, schlägt die Funktion fehl.

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 getstr(), mvgetstr(), mvwgetstr() oder wgetstr() eine Zeile
     gelesen, die zu einem Überlauf des Array führt, auf den str zeigt,
     kommt es zu nicht definierten Ergebnissen. Hier wird die Verwendung
     der Funktionen getnstr(), mvgetnstr(), mvwgetnstr() bzw. wgetnstr()
     empfohlen.

SIEHE AUCH
     beep(3X), curses(3X), getch(3X), curses(5).































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98