Masks.MatchesMask
Contents |
Delphi-Informationen
von Masks.pas
function MatchesMask(const Filename: string; const Mask: string): Boolean;
Unit: Masks
Typ: Funktion
Sichtbarkeit: public
C++-Informationen
von Masks.hpp
bool __fastcall MatchesMask(System::UnicodeString Filename, System::UnicodeString Mask);
Unit: Masks
Typ: Funktion
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.
Anmerkung: Der Parameter Filename muss keinen Dateinamen enthalten. MatchesMask wird zur Überprüfung von Strings anhand syntaktisch korrekter Masken verwendet.
Siehe auch
Codebeispiele