ckint(1M) ckint(1M)
NAME
ckint, errint, helpint, valint - Zeigt eine Eingabeaufforderung an,
überprüft die Eingabe des Benutzers und gibt eine ganze Zahl zurück
SYNTAX
/usr/bin/ckint [-Q] [-W width] [-b base] [-d default] [-h help]
[-e error] [-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/errint [-W] [-b base] [-e error]
/usr/sadm/bin/helpint [-W] [-b base] [-h help]
/usr/sadm/bin/valint [-b base] input
BESCHREIBUNG
ckint fordert den Benutzer zu einer Eingabe auf und überprüft dann die
Eingabe auf ihre Gültigkeit. Zusätzlich kann unter anderem eine Einga-
beaufforderung, auf die hin eine ganze Zahl eingegeben werden muß,
definiert werden, ebenso ein Hilfetext, Fehlermeldungen und ein Stan-
dardwert, der zurückgegeben wird, wenn der Benutzer die Eingabeauffor-
derung mit <RETURN> beantwortet.
Meldungen dürfen höchstens 70 Zeichen lang sein und werden automatisch
formatiert. Zwischenräume in der Definition, auch das Neue-Zeile-
Zeichen, werden entfernt. Die Option -W unterdrückt die automatische
Formatierung. Beginnt oder endet die Definition einer Meldung mit
einer Tilde, wird an dieser Stelle der Standardtext eingesetzt, so daß
Standardtext und vom Benutzer definierter Text zusammen angezeigt wer-
den können.
Wenn keine Eingabeaufforderung, Hilfe- oder Fehlermeldung definiert
wird, wird die unter HINWEISE beschriebene Standardmeldung angezeigt.
Drei visuelle Module sind mit dem Kommando ckint verbunden, nämlich
errint zur Formatierung und Anzeige einer Fehlermeldung, helpint zur
Formatierung und Anzeige einer Hilfemeldung und valint zur Überprüfung
der Benutzereingabe. Diese Module sollten zusammen mit FML-Objekten
benutzt werden. In diesem Fall definiert das FML-Objekt die Eingabe-
aufforderung. Wird base in den Modulen errint und helpint definiert,
enthalten die Meldungen die erwartete Basis für die Eingabe.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckint(1M) ckint(1M)
OPTIONEN
-Q Gibt an, daß quit nicht als gültige Antwort erlaubt ist.
-W Gibt an, daß Eingabeaufforderung, Hilfe- und Fehlermeldung auf
eine Zeilenlänge von width formatiert werden.
-b Definiert die Basis für die Eingabe. Der Wert muß zwischen 2
und 36 liegen. Der Standardwert ist 10.
-d Definiert default als den Standardwert. Der Standardwert wird
nicht auf seine Gültigkeit hin überprüft und braucht daher kei-
nen Kriterien zu entsprechen.
-h Definiert help als die Hilfemeldung.
-e Definiert error als die Fehlermeldung.
-p Definiert prompt als die Meldung, die als Eingabeaufforderung
angezeigt wird.
-k Gibt an, daß an die Prozeßnummer pid ein Signal gesendet werden
soll, wenn der Benutzer mit q abbricht.
-s Gibt an, daß an die Prozeßnummer pid, die mit der Option -k
definiert wurde, das Signal signal gesendet werden soll, wenn
der Benutzer quit wählt. Wird kein Signal angegeben, wird SIG-
TERM benutzt.
eingabe
Ist die Eingabe, die anhand von base überprüft wird.
DIAGNOSE
0 = Ausführung erfolgreich
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckint(1M) ckint(1M)
HINWEISE
Die standardmäßige Eingabeaufforderung des Kommandos ckint für die
Basis 10 lautet:
Enter an integer [?,q]:
(Ganze Zahl eingeben [?,q]:)
Die Standardfehlermeldung für die Basis 10 lautet:
ERROR - Please enter an integer.
(FEHLER - Bitte eine ganze Zahl eingeben.)
Die Standardhilfemeldung für die Basis 10 lautet:
Please enter an integer.
(Bitte eine ganze Zahl eingeben.)
Statt "integer" erscheint in den Meldungen "base base integer", wenn
als Basis eine andere Zahl als 10 gesetzt wird.
Ist die Option quit erlaubt und wird sie gewählt, wird q zusammen mit
dem Rückkehrcode 3 zurückgegeben. Das Modul valint erzeugt keine Aus-
gabe. Bei erfolgreicher Ausführung wird Null, andernfalls eine andere
Zahl zurückgegeben.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98