ckstr(1M) ckstr(1M)
NAME
ckstr, errstr, helpstr, valstr - Zeigt eine Eingabeaufforderung an;
überprüft eine eingegebene Zeichenkette und gibt sie zurück
SYNTAX
/usr/bin/ckstr [-Q] [-W width] [[-r regexp] [...]] [-l length]
[-d default] [-h help] [-e error] [-p prompt]
[-k pid [-s signal]]
/usr/sadm/bin/errstr [-W] [-e error]
/usr/sadm/bin/helpstr [-W] [-h help]
/usr/sadm/bin/valstr input
BESCHREIBUNG
ckstr fordert den Benutzer zu einer Eingabe auf und überprüft diese.
Unter anderem kann damit eine Eingabeaufforderung definiert werden,
auf die mit einer Zeichenkette geantwortet werden soll; es kann Text
für Hilfe- und Fehlermeldungen und ein Standardwert definiert werden,
der zurückgegeben wird, wenn der Benutzer als Antwort <RETURN> ein-
gibt.
Der zurückgegebene Wert muß dem definierten regulären Ausdruck ent-
sprechen und darf die angegebene Länge nicht überschreiten. Ist kein
regulärer Ausdruck angegeben, muß die Eingabe aus einer Zeichenkette
bestehen, deren Länge geringer oder gleich dem angegebenen Wert ist
und die ohne führende, interne oder nachfolgende Zwischenraumzeichen
definiert ist. Ist keine Länge definiert, wird dieser Wert nicht über-
prüft. Mit dem Kommando muß entweder ein regulärer Ausdruck oder ein
Längenwert angegeben werden.
Alle Meldungen dürfen 70 Zeichen lang sein und werden automatisch for-
matiert. In der Definition verwendete Zwischenraumzeichen einschließ-
lich des Neue-Zeile-Zeichens werden entfernt. Mit der Option -W wird
die automatische Formatierung ausgeschaltet. Steht am Anfang oder am
Ende einer Meldungsdefinition eine Tilde, wird an dieser Stelle der
Standardtext eingefügt, und sowohl der angepaßte als auch der Stan-
dardtext angezeigt.
Wird die Eingabeaufforderung, Hilfemeldung oder Fehlermeldung nicht
definiert, erscheint die Standardmeldung wie unter HINWEISE beschrie-
ben.
Mit dem Kommando ckstr sind drei visuelle Module verbunden, und zwar
errstr (formatiert eine Fehlermeldung und zeigt sie an), helpstr (for-
matiert eine Hilfemeldung und zeigt sie an) und valstr (überprüft die
Antwort). Diese Module sollten Sie zusammen mit FACE-Objekten benut-
zen. In diesem Falle definiert das FACE-Objekt die Eingabeaufforde-
rung.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
ckstr(1M) ckstr(1M)
OPTIONEN
-Q Gibt an, daß quit keine gültige Antwort ist.
-W Bestimmt, daß Eingabeaufforderungen, Hilfe- und Fehlermeldungen
mit der Länge width formatiert werden.
-r Gibt einen regulären Ausdruck regexp an, anhand dessen die Ein-
gabe überprüft werden muß. Dieser Ausdruck darf Zwischenraum-
zeichen enthalten. Werden mehrere Ausdrücke definiert, muß die
Antwort nur einem davon entsprechen.
-l Gibt die maximale Länge der Eingabe an.
-d Definiert default als den Standardwert. Der Standardwert wird
nicht überprüft und muß daher keinerlei Kriterien entsprechen.
-h Definiert help als die Hilfemeldungen.
-e Definiert error als die Fehlermeldung.
-p Definiert prompt als die Eingabeaufforderung.
-k Gibt an, daß an die Prozeßnummer pid ein Signal gesendet wird,
wenn der Benutzer die Ausführung durch quit abbricht.
-s Bestimmt, daß an die mit der Option -k definierte Prozeßnummer
pid ein Signal signal gesendet wird, wenn quit ausgewählt wird.
Wird kein Signal angegeben, wird SIGTERM verwendet.
input Die Eingabe muß anhand der Kriterien Formatlänge und/oder regu-
lärer Ausdruck überprüft werden.
DIAGNOSE
0 = Erfolgreiche Ausführung
1 = EOF (Dateiende) bei Eingabe
2 = Falsche Verwendung
3 = Abbruch durch Benutzer (quit)
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
ckstr(1M) ckstr(1M)
HINWEISE
Die Standard-Eingabeaufforderung bei ckstr lautet:
Enter an appropriate value [?,q]:
(Geeigneten Wert eingeben [?,q]:)
Die Standard-Fehlermeldung hängt davon ab, welche Art von Überprüfung
vorgenommen wird. Dem Benutzer wird mitgeteilt, daß entweder der
Längen- oder der Mustervergleich fehlgeschlagen ist. Die Standard-
Hilfemeldung hängt ebenfalls vom Typ der Überprüfung ab. Wurde ein
regulärer Ausdruck definiert, lautet die Meldung:
Please enter a string which matches the following pattern:
regexp
(Bitte eine Zeichenkette eingeben, die folgendem Muster entspricht:
regexp)
In anderen Meldungen werden die erforderliche Länge und die Definition
einer Zeichenkette definiert. Wird quit gewählt (und ist zulässig),
wird q zusammen mit dem Rückkehrcode 3 zurückgegeben. Das Modul valstr
erzeugt keinerlei Ausgabe. Es gibt bei Erfolg eine Null zurück und ein
anderes Zeichen, das nicht Null ist, wenn die Operation fehlschlägt.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98