System.Masks.MatchesMask

• Übergeordnet: System.Masks

Delphi

function MatchesMask(const Filename, Mask: string): Boolean;

C++

extern DELPHI_PACKAGE bool __fastcall MatchesMask(const System::UnicodeString Filename, const System::UnicodeString Mask);

Eigenschaften

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

Beschreibung

Gibt an, ob ein Dateiname oder ein anderer Quell-String dem in einem Filter-String angegebenen Format entspricht.

Mit MatchesMask können Sie den Parameter Filename auf die im Parameter Mask enthaltenen Werte hin überprüfen. Eine gültige Maske besteht aus literalen Zeichen, Mengen und Platzhaltern.

Jedes literale Zeichen muss mit einem einzelnen Zeichen im String übereinstimmen. Beim Vergleich literaler Zeichen wird die Groß-/Kleinschreibung nicht berücksichtigt.

Jede Mengendefinition beginnt mit einer öffnenden eckigen Klammer ([) und endet mit einer schließenden (]). Zwischen den Klammern befinden sich die Elemente der Menge. Jedes Element ist ein literales Zeichen oder ein Bereich. Bereiche werden durch einen Anfangswert, einen Bindestrich (-) und einen Endwert definiert. Verwenden Sie keine Leerzeichen oder Kommas als Trennzeichen für die Mengenelemente. Eine Menge definiert mögliche Übereinstimmungen für ein Einzelzeichen. Das Zeichen gilt dann als übereinstimmend, wenn es mit einem der literalen Zeichen in der Menge identisch ist oder wenn es in einen der definierten Bereiche fällt. Dies ist dann der Fall, wenn das Zeichen mit dem Startwert, dem Endwert oder einem dazwischenliegenden Zeichen übereinstimmt. Bei allen Vergleichen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn das erste Zeichen nach der öffnenden Klammer ein Ausrufezeichen ist, dann wird die Mengendefinition invertiert, das heißt, ein Zeichen gilt dann als akzeptiert, wenn es sich nicht in der Menge befindet.

Als Platzhalter stehen das Sternchen (*) und das Fragezeichen zur Verfügung. Ein Sternchen deckt eine beliebige Anzahl von Zeichen ab. Ein Fragezeichen ist Platzhalter für ein einziges Zeichen.

MatchesMask gibt den Wert true zurück, wenn der String mit der Maske übereinstimmt. Andernfalls wird false zurückgegeben. MatchesMask löst eine Exception aus, wenn die Maske einen Syntaxfehler enthält.

Hinweis:  Der Parameter Filename muss keinen Dateinamen enthalten. MatchesMask wird zur Überprüfung von Strings anhand syntaktisch korrekter Masken verwendet.

Siehe auch

• TMask

Codebeispiele

• MatchesMask (Delphi)
• MatchesMask (C++)