FileSystem.GetPathMatcher(String) Méthode

[Android.Runtime.Register("getPathMatcher", "(Ljava/lang/String;)Ljava/nio/file/PathMatcher;", "GetGetPathMatcher_Ljava_lang_String_Handler", ApiSince=26)]
public abstract Java.Nio.FileNio.IPathMatcher? GetPathMatcher(string? syntaxAndPattern);

[<Android.Runtime.Register("getPathMatcher", "(Ljava/lang/String;)Ljava/nio/file/PathMatcher;", "GetGetPathMatcher_Ljava_lang_String_Handler", ApiSince=26)>]
abstract member GetPathMatcher : string -> Java.Nio.FileNio.IPathMatcher

Paramètres

Retours

Un matcheur de chemin d’accès qui peut être utilisé pour faire correspondre les chemins d’accès au modèle

Attributs

RegisterAttribute

Remarques

Retourne une PathMatcher opération de correspondance sur la String représentation des Path objets en interprétant un modèle donné.

Le syntaxAndPattern paramètre identifie la syntaxe et le modèle et prend la forme : <blockquote>

<i>syntax</i><b>:</b><i>pattern</i>

</blockquote> , où ':' se trouve lui-même.

Une FileSystem implémentation prend en charge les syntaxes «glob » et «regex » et peut prendre en charge d’autres. La valeur du composant de syntaxe est comparée sans tenir compte du cas.

Lorsque la syntaxe est «glob », la String représentation du chemin est mise en correspondance à l’aide d’un langage de modèle limité qui ressemble à des expressions régulières, mais avec une syntaxe plus simple. Par exemple:

<table class="striped » style="text-align :left ; margin-left :2em"><caption style="display :none">Pattern Language</caption><thead><tr><th scope="col">Example <th scope="col">Description </tr<>/thead<>tbody<>tr><th scope="row"<*.java>/th><td>Correspond à un chemin qui représente un nom de fichier se terminant par .java</td<>/tr<><>th scope="row"*.*></th><td>Correspond aux noms de fichiers contenant un point</td<>/tr tr<><>th scope="row">*.{java,class}</th><td>Correspond aux noms de fichiers se terminant par .java ou<.class /td></tr<>tr<>th scope="row"<foo.?>/th><td>Correspond aux noms de fichiers commençant par foo. et une seule extension< de caractère/td<>/tr tr>><<th scope="row">/home/*/*<td>Matches //home/gus/data< td>/tr tr><><th scope="row"></home/**td>Matches /home/gus and /home/gus/data</td></tr></tbody<>/table<>

Les règles suivantes sont utilisées pour interpréter les modèles glob :

<ul><li>

Le * caractère correspond à zéro ou plus Character characters d’un Path#getName(int) name composant sans traverser les limites du répertoire.

</li>

<li>

Les ** caractères correspondent à zéro ou plusieurs Character characters limites de répertoires.

</li>

<li>

Le ? caractère correspond exactement à un caractère d’un composant de nom.

</li>

<li>

Le caractère de barre oblique inverse (\) est utilisé pour échapper des caractères qui seraient autrement interprétés comme des caractères spéciaux. L’expression \\ correspond à une barre oblique inverse unique et « \{ » correspond à une accolade gauche, par exemple.

</li>

<li>

Les [ ] caractères sont une expression entre crochets qui correspondent à un caractère unique d’un composant de nom à partir d’un ensemble de caractères. Par exemple, [abc] correspond "a", "b"ou "c". Le trait d’union (-) peut être utilisé pour spécifier une plage afin de [a-z] spécifier une plage qui correspond à "z" partir de "a" (inclusive). Ces formes peuvent être mélangées de sorte que [abce-g] correspond "a", "b", , "c", "e""f" ou "g". Si le caractère après l’objet [ est alors utilisé ! pour la négation, il correspond donc [!a-c] à n’importe quel caractère sauf "a", "b"ou "c".

Dans une expression entre crochets, ? les *caractères correspondent \ eux-mêmes. Le caractère (-) correspond lui-même s’il s’agit du premier caractère entre crochets ou du premier caractère après la ! négation.

</li>

<li>

Les {caractères } sont un groupe de sous-modèles, où le groupe correspond si un sous-modèle dans le groupe correspond. Le "," caractère est utilisé pour séparer les sous-modèles. Les groupes ne peuvent pas être imbriqués.

</li>

<li>

Les caractères points de point/de début dans le nom de fichier sont traités comme des caractères réguliers dans les opérations de correspondance. Par exemple, le "*" modèle glob correspond au nom ".login"de fichier . La Files#isHidden méthode peut être utilisée pour tester si un fichier est considéré comme masqué.

</li>

<li>

Tous les autres caractères correspondent eux-mêmes d’une manière dépendante de l’implémentation. Cela inclut des caractères représentant n’importe quel FileSystem#getSeparator name-separators.

</li>

<li>

La correspondance des composants dépend fortement de Path#getRoot root l’implémentation et n’est pas spécifiée.

</li>

</ul>

Lorsque la syntaxe est «regex », le composant de modèle est une expression régulière telle que définie par la java.util.regex.Pattern classe.

Pour les syntaxes glob et regex, les détails correspondants, tels que si la correspondance respecte la casse, dépendent de l’implémentation et ne sont donc pas spécifiés.

Java documentation pour java.nio.file.FileSystem.getPathMatcher(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.