System.SysUtils.FindCmdLineSwitch

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FindCmdLineSwitch(const Switch: string; const Chars: TSysCharSet; IgnoreCase: Boolean): Boolean;
function FindCmdLineSwitch(const Switch: string): Boolean;
function FindCmdLineSwitch(const Switch: string; IgnoreCase: Boolean): Boolean;
function FindCmdLineSwitch(const Switch: string; var Value: string; IgnoreCase: Boolean = True; const SwitchTypes: TCmdLineSwitchTypes = [clstValueNextParam, clstValueAppended]): Boolean; overload;

C++

extern DELPHI_PACKAGE bool __fastcall FindCmdLineSwitch(const System::UnicodeString Switch, const TSysCharSet &Chars, bool IgnoreCase)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Beschreibung

Ermittelt, ob ein String als Befehlszeilenargument an die Anwendung übergeben wurde.

FindCmdLineSwitch ermittelt, ob ein String eine Befehlszeilenoption repräsentiert. Maßgebend ist das erste Zeichen des Strings.

  • Switch ist ein Befehlszeilenparameter, nach dem gesucht werden soll.
  • Chars ist die Zeichenmenge, die Optionen von anderen Parametern unterscheidet. Wird Switch weggelassen, wird auf Unix-Systemen der Standardwert '-' und auf Windows-Systemen '/' und '-' verwendet.
  • IgnoreCase legt fest, ob Zeichen unter Berücksichtigung der Groß- und Kleinschreibung verglichen werden. Die Vorgabe ist True. Mit dieser Funktion können außer dem Suchen nach Befehlszeilenoptionen auch Parameterwerte für diese Überladung abgerufen werden.
  • Value gibt den Wert zurück, der der angegebenen Option zugeordnet ist.
  • SwitchTypes legt fest, wie Parameterwerte analysiert werden:
Konstante Wert
clstValueNextParam -p Value
clstValueAppended -pValue oder -p:Value

Der Parameter clstValueNextParam gibt an, dass Werte durch ein Leerzeichen von der Option getrennt werden. Der Parameter clstValueAppended gibt an, dass die Werte unmittelbar nach der Option (kein Leerzeichen) oder nach einem Doppelpunkt angehängt werden. SwitchTypes ist ein Mengentypparameter, der standardmäßig die Rückgabe beider Parametertypen – [clstValueNextParam, clstValueAppended] – zulässt. Einzelne Optionstypen können ebenfalls angegeben werden. Ein leerer SwitchType-Parameter, [], führt dazu, dass keine Werte zurückgegeben werden. Übergeben Sie den Parameter SwitchTypes, um alle Optionstypen auszuschließen (Switch kann 1 oder mehr Zeichen lang sein).

Siehe auch