System.Masks.MatchesMask

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Masks.pas
System.Masks.hpp
System.Masks System.Masks

Description

Indique si un nom de fichier est conforme au format spécifié par une chaîne de filtrage.

Appelez MatchesMask pour tester le paramètre Filename à l'aide du paramètre Masque pour décrire les valeurs autorisées. Un masque valide est composé de caractères littéraux, d'ensembles et de caractères génériques.

Chaque caractère littéral correspond exactement à un caractère unique de la chaîne. La comparaison avec les caractères littéraux ne tient pas compte de la distinction minuscules/majuscules.

Chaque ensemble commence par un crochet ouvrant ([) et se termine par un crochet fermant (]). Les éléments de l'ensemble sont placés entre les crochets. Chaque élément est soit un caractère littéral, soit un intervalle. Les intervalles sont spécifiés par une valeur initiale, un tiret (-) et une valeur finale. N'utilisez pas d'espaces ou de virgules pour séparer les éléments de l'ensemble. Un ensemble doit correspondre à caractère unique de la chaîne. Le caractère correspond à l'ensemble s'il est identique à l'un des caractères littéraux de l'ensemble ou s'il appartient à l'un des intervalles de l'ensemble. Un caractère appartient à un intervalle s'il correspond à la valeur initiale, à la valeur finale ou à l'un des caractères situé entre ces deux valeurs. Toutes les comparaisons ne tiennent pas compte de la distinction minuscules/majuscules. Si le premier caractère de l'ensemble après le crochet ouvrant est un point d'exclamation (!), l'ensemble correspond à tout caractère ne se trouvant pas dans l'ensemble.

Les caractères génériques sont l'astérisque (*) et le point d'interrogation (?). Un astérisque correspond à un nombre quelconque de caractères. Un point d'interrogation correspond à un caractère arbitraire unique.

MatchesMask renvoie true si la chaîne correspond au masque. MatchesMask renvoie false si la chaîne ne correspond pas au masque. MatchesMask déclenche une exception si le masque est syntaxiquement incorrect.

Remarque:  Le paramètre Filename ne doit pas nécessairement être un nom de fichier. MatchesMask peut servir à vérifier des chaînes à l'aide d'un masque syntaxiquement correct.

Voir aussi