innwstr(3X)                                                     innwstr(3X)

NAME
     innwstr, inwstr, mvinnwstr, mvinwstr, mvwinnwstr, mvwinwstr, winnwstr,
     winwstr - Einen Wide-Character-String aus einem Fenster eingeben

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

     #include <curses.h>

     int innwstr(wchart *wstr, int n);

     int inwstr(wchart *wstr);

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

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

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

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

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

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

BESCHREIBUNG
     Diese Funktionen schreiben einen String bestehend aus Zeichen des Typs
     wchart aus dem aktuellen oder angegebenen Fenster in den Array, auf
     den wstr zeigt, beginnend bei der aktuellen oder angegebenen Position
     bis zum Ende der Zeile.

     Die Funktionen speichern nur die gesamte, einem komplexen Zwischen-
     raumzeichen zugeordnete Wide-Character-Sequenz. Wenn der Array groß
     genug ist, um zumindest ein vollständiges komplexes Zwischenraumzei-
     chen aufzunehmen, füllt die Funktion den Array mit vollständigen Zei-
     chen auf. Wenn der Array zur Aufnahme eines vollständigen komplexen
     Zeichens nicht ausreicht, schlägt die Funktion fehl.

     Die Funktionen innwstr(), mvinnwstr(), mvwinnwstr() und winnwstr()
     speichern maximal n Bytes in den Array, auf den wstr zeigt.

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben die Funktionen inwstr(),
     mvinwstr(), mvwinwstr() und winwstr() den Wert OK zurück.

     Nach erfolgreicher Ausführung geben die Funktionen innwstr(),
     mvinnwstr(), mvwinnwstr() und winnwstr() die Anzahl der tatsächlich in
     den String gelesenen Zeichen zurück.

     Andernfalls geben die Funktionen den Wert ERR zurück.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

innwstr(3X)                                                     innwstr(3X)

FEHLER
     Es sind keine Fehlerzuordnungen definiert.

HINWEISE
     Wird mit inwstr(), mvinwstr(), mvwinwstr() oder winwstr() eine Zeile
     gelesen, die zu einem Überlauf des Array führt, auf den wstr zeigt,
     kommt es zu nicht definierten Ergebnissen. Hier wird die Verwendung
     der Funktionen innwstr(), mvinnwstr(), mvwinnwstr() bzw. winnwstr()
     empfohlen.

     Die Funktionen geben keine Daten zur Darstellung zurück.

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








































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98