INPUT zeigt optional eine Eingabeaufforderung an, wartet dann auf Ihre Eingabe und speichert sie in einer Umgebungs- oder Array-Variablen. INPUT wird normalerweise in Stapeldateien und Aliasen verwendet, um mehrstellige Eingaben zu erhalten (für die Eingabe eines einzelnen Tastendrucks siehe INKEY).

INPUT funktioniert innerhalb des Kommandozeilenfensters. Wenn Sie es vorziehen, einen Dialog für Benutzereingaben zu verwenden, lesen Sie die Befehle MSGBOX und QUERYBOX.

Wenn in einem INPUT-Befehl ein Prompt-Text enthalten ist, wird dieser angezeigt, während INPUT auf eine Eingabe wartet. Die Standard-Befehlszeilen-Editiertasten können verwendet werden, um die Eingabezeichenfolge während der Eingabe zu bearbeiten. Wenn Sie die Kennwortoption/P verwenden , gibt INPUT anstelle der eingegebenen Tasten Sternchen aus.

INPUT kehrt zurück, wenn Sie den Wagenrücklauf drücken. Alle Zeichen, die bis zum Wagenrücklauf eingegeben werden, werden in der Variablen gespeichert.

Das folgende Batch-Dateifragment fragt nach einer Zeichenkette und speichert sie in der Variablen FNAME:

input Geben Sie den Dateinamen ein: %%fname

INPUT liest Standardeingaben, akzeptiert also auch Text aus einer umgeleiteten Datei oder aus dem KEYSTACK.

INPUT unterstützt reguläre Ausdrücke für die Maske (/K "xxx"). Dem regulären Ausdruck muss ein :: vorangestellt werden - zum Beispiel:

INPUT /K"::^[0-9]$" Geben Sie eine Zahl ein: %%number

Numeric input may be entered in either decimal format (a sequence of 0-9 digits) or in hexadecimal format ("0x" followed by a sequence of 0-F hex digits).

Wenn Sie Strg-C oder Strg-Break drücken, während INPUT auf eine Eingabe wartet, wird die Ausführung eines Alias beendet, und die Ausführung einer Batch-Datei wird unterbrochen, während Sie gefragt werden, ob Sie den Batch-Job abbrechen möchten. Eine Batch-Datei kann Ctrl-C und Ctrl-Break selbst mit dem ON BREAK-Befehlverarbeiten .

Sie können Text über die Pipeline an INPUT übergeben, doch wird die Variable in dem "Kind"-Prozess gesetzt, der für die rechte Seite der Pipeline verwendet wird. Diese Variable ist nicht in der ursprünglichen Kopie von TCC verwendet, um die Pipe zu starten.

Wenn Sie keine Argumente eingeben, zeigt INPUT seinen Befehlsdialog an.

Optionen:

/=	Zeigt den INPUT-Befehlsdialog an, um Ihnen beim Einstellen der Befehlszeilenoptionen zu helfen. Die Option /= kann an einer beliebigen Stelle in der Zeile stehen; zusätzliche Optionen setzen die entsprechenden Felder im Befehlsdialog.

/C	Verwirft alle anstehenden Tastenanschläge im Tastaturpuffer, bevor INPUT mit der Annahme von Zeichen beginnt.

/D	Akzeptiert nur Zahlen von 0 bis 9.

Ermöglicht die Bearbeitung eines vorhandenen Wertes. Wenn kein Wert für varname vorhanden ist, verfährt INPUT so, als ob /E nicht benutzt worden wäre, und erlaubt Ihnen, einen neuen Wert einzugeben. Wenn es keinen vorhandenen Wert gibt und Sie einen optionalen Standardwert angeben , zeigt INPUT den Standardwert zur Bearbeitung an.

/K "keys"

Legt die zulässigen Tastenanschläge fest. Die Liste der zulässigen Tastenanschläge sollte in doppelte Anführungszeichen gesetzt werden. Bei alphabetischen Tasten wird bei der Prüfung der Gültigkeit nicht zwischen Groß- und Kleinschreibung unterschieden.

Zum Beispiel:

input /k"[0-9]-()" Geben Sie Ihre Telefonnummer ein: %%var

Sie können erweiterte Tasten angeben, indem Sie deren Namen in eckige Klammern (innerhalb der Anführungszeichen) setzen. Unter Tasten und Tastennamen finden Sie eine vollständige Liste der Tastennamen, die Sie innerhalb der eckigen Klammern verwenden können, sowie eine Beschreibung des Formats der Tastennamen.

Wenn ein ungültiger Tastendruck eingegeben wird, TCC einen Piepton und wartet auf einen weiteren Tastendruck.

/Lmax[:min]

Setzt die maximale Anzahl von Zeichen, die INPUT akzeptiert, auf max. Wenn Sie versuchen, mehr als diese Anzahl von Zeichen einzugeben, gibt INPUT einen Signalton aus und verhindert die weitere Eingabe (Sie können die Zeichen, die Sie vor Erreichen des Limits eingegeben haben, immer noch bearbeiten). Der optionale Parametermin legt die Mindestanzahl von Zeichen fest, die INPUT akzeptiert.

/N	Deaktiviert die Verwendung der in den KonfigurationsoptionenFarbendefinierten Eingabefarben und zwingt INPUT, die Standardanzeigefarben zu verwenden.

/P	Weist INPUT an, Sternchen anstelle der eingegebenen Zeichen auszugeben.

/T	Anzeige eines Countdown-Timers (/Wn ist ebenfalls erforderlich).

Wartezeit in Sekunden, um auf eine Antwort zu warten. Wird bis zum Ende der Timeout-Periode kein Tastendruck eingegeben, kehrt INPUT mit unveränderter Variable zurück. Auf diese Weise können Sie die Stapeldatei fortsetzen, wenn der Benutzer nicht innerhalb einer bestimmten Zeitspanne antwortet. Wenn Sie eine Taste vor der Timeout-Periode eingeben, wartet INPUT auf unbestimmte Zeit auf den Rest der Zeile. Sie können /W0angeben , um sofort zurückzukehren, wenn keine Tasten im Tastaturpuffer warten.

/X	Verhindert, dass INPUT nach der Eingabe des Benutzers einen Wagenrücklauf und einen Zeilenvorschub einfügt.