Referenční informace ke vzorům porovnávání souborů

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Syntaxe vzoru

Vzor je řetězec nebo seznam řetězců oddělených novým řádkem. Názvy souborů a adresářů se porovnávají se vzory, které se mají zahrnout (nebo někdy vyloučit) do úkolu. Složité chování můžete vytvořit tak, že naskládáte několik vzorů. Úplný průvodce syntaxí najdete v tématu fnmatch .

Shoda znaků

Většina znaků se používá jako přesná shoda. Co se počítá jako "přesná" shoda je závislá na platformě: systém souborů Windows nerozlišuje malá a velká písmena, takže vzor "ABC" by odpovídal souboru s názvem "abc". V systému souborů rozlišujících malá a velká písmena by se tento vzor a název neshodovaly.

Následující znaky mají zvláštní chování.

• * odpovídá nule nebo více znaků v názvu souboru nebo adresáře. Podívejte se na příklady.
• ? odpovídá jakémukoli jednomu znaku v názvu souboru nebo adresáře. Podívejte se na příklady.
• [] odpovídá sadě nebo rozsahu znaků v názvu souboru nebo adresáře. Podívejte se na příklady.
• ** rekurzivní zástupný znak. Například /hello/**/* odpovídá všem potomkům ./hello

Rozšířené globbing

• ?(hello|world) - shody hello nebo world nula nebo jednou
• *(hello|world) – nula nebo více výskytů
• +(hello|world) - jeden nebo více výskytů
• @(hello|world) - přesně jednou
• !(hello|world)- ne nebo ne helloworld

Poznámka: Rozšířené globy nemohou zahrnovat oddělovače adresářů. Například +(hello/world|other) není platný.

Komentáře

Vzory, které začínají # , se považují za komentáře.

Vyloučení vzorů

Vedoucí ! změny významu vzorce zahrnutí, který se má vyloučit. Můžete zahrnout vzor, vyloučit jeho podmnožinu a pak znovu zahrnout podmnožinu, která se označuje jako "prokládání".

Více ! překlopí význam. Podívejte se na příklady.

Před vyloučením je nutné definovat vzor zahrnutí. Podívejte se na příklady.

Úniku

Zalamování speciálních znaků [] lze použít k řídicím literálovým znakům globu v názvu souboru. Například název hello[a-z] literálového souboru může být uchvácený jako hello[[]a-z].

Lomítko

/ se používá jako oddělovač cest v Linuxu a macOS. Ve většině případů agenti Systému Windows přijímají /. Příležitosti, kdy je nutné použít oddělovač windows (\) je zdokumentovaný.

Příklady

Základní příklady vzorů

Příklady hvězdičky

Příklad 1: Vzhledem k vzoru *Website.sln a souborům:

ConsoleHost.sln
ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

Vzor by odpovídal:

ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

Příklad 2: Vzhledem k vzoru *Website/*.proj a cestám:

ContosoWebsite/index.html
ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/index.html
FabrikamWebsite/FabrikamWebsite.proj

Vzor by odpovídal:

ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/FabrikamWebsite.proj

Příklady otazníku

Příklad 1: Vzhledem k vzoru log?.log a souborům:

log1.log
log2.log
log3.log
script.sh

Vzor by odpovídal:

log1.log
log2.log
log3.log

Příklad 2: Vzhledem k vzoru image.??? a souborům:

image.tiff
image.png
image.ico

Vzor by odpovídal:

image.png
image.ico

Příklady znakové sady

Příklad 1: Vzhledem k vzoru Sample[AC].dat a souborům:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

Vzor by odpovídal:

SampleA.dat
SampleC.dat

Příklad 2: Vzhledem k vzoru Sample[A-C].dat a souborům:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

Vzor by odpovídal:

SampleA.dat
SampleB.dat
SampleC.dat

Příklad 3: Vzhledem k vzoru Sample[A-CEG].dat a souborům:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat
SampleE.dat
SampleF.dat
SampleG.dat
SampleH.dat

Vzor by odpovídal:

SampleA.dat
SampleB.dat
SampleC.dat
SampleE.dat
SampleG.dat

Příklady rekurzivních zástupných znaků

Vzhledem k vzoru **/*.ext a souborům:

sample1/A.ext
sample1/B.ext
sample2/C.ext
sample2/D.not

Vzor by odpovídal:

sample1/A.ext
sample1/B.ext
sample2/C.ext

Příklady vyloučení vzorů

Vzhledem k vzoru:

*
!*.xml

a soubory:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Vzor by odpovídal:

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb

Dvojité vyloučení

Vzhledem k vzoru:

*
!*.xml
!!Fabrikam.xml

a soubory:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Vzor by odpovídal:

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Vyloučení složky

Vzhledem k vzoru:

**
!sample/**

a soubory:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
sample/Fabrikam.dll
sample/Fabrikam.pdb
sample/Fabrikam.xml

Vzor by odpovídal:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml