innstr(3X)                                                       innstr(3X)

NAME
     innstr, instr, mvinnstr, mvinstr, mvwinnstr, mvwinstr, winnstr, winstr
     - Einen Mehrbytezeichen-String aus einem Fenster eingeben

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

     #include <curses.h>

     int innstr(char *str, int n);

     int instr(char *str);

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

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

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

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

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

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

BESCHREIBUNG
     Diese Funktionen schreiben einen String aus dem aktuellen oder angege-
     benen Fenster in den Array, auf den str zeigt, beginnend bei der aktu-
     ellen oder angegebenen Position bis zum Ende der Zeile.

     Die Funktionen innstr(), mvinnstr(), mvwinnstr() und winnstr() spei-
     chern maximal n Bytes in den String, auf den str zeigt.

     Die Funktionen innstr(), mvinnstr(), mvwinnstr() und winnstr() spei-
     chern nur die gesamte, dem Zeichen zugeordnete Mehrbytesequenz. Wenn
     der Array groß genug ist, um zumindest ein Zeichen aufzunehmen, füllt
     die Funktion den Array mit vollständigen Zeichen auf. Wenn der Array
     zur Aufnahme eines vollständigen Zeichens nicht ausreicht, schlägt die
     Funktion fehl.

RÜCKGABEWERT
     Nach erfolgreicher Ausführung geben die Funktionen instr(), mvinstr(),
     mvwinstr() und winstr() den Wert OK zurück.

     Nach erfolgreicher Ausführung geben die Funktionen innstr(),
     mvinnstr(), mvwinnstr() und winnstr() die Anzahl der tatsächlich in
     den String gelesenen Zeichen zurück.

     Andernfalls geben die Funktionen den Wert ERR zurück.

FEHLER
     Es sind keine Fehlerzuordnungen definiert.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

innstr(3X)                                                       innstr(3X)

HINWEISE
     Da Mehrbytezeichen verarbeitet werden, liegt möglicherweise keine
     Eins-zu-Eins-Entsprechung zwischen der Anzahl der auf dem Bildschirm
     angezeigten Spaltenpositionen und der Anzahl der zurückgegebenen Bytes
     vor.

     Die Funktionen geben keine Daten zur Darstellung zurück.

     Wird mit instr(), mvinstr(), mvwinstr() oder winstr() eine Zeile gele-
     sen, die zu einem Überlauf des Array führt, auf den str zeigt, kommt
     es zu nicht definierten Ergebnissen. Hier wird die Verwendung der
     Funktionen innstr(), mvinnstr(), mvwinnstr() bzw. winnstr() empfohlen.

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







































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98