Bagikan melalui

Referensi pola pencocokan file

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Sintaks pola

Pola adalah string atau daftar string yang dibatasi baris baru. Nama file dan direktori dibandingkan dengan pola untuk menyertakan (atau terkadang mengecualikannya) dalam tugas. Anda dapat membangun perilaku kompleks dengan menumpuk beberapa pola. Lihat fnmatch untuk panduan sintaks lengkap.

Cocokkan karakter

Sebagian besar karakter digunakan sebagai kecocokan yang tepat. Apa yang dihitung sebagai kecocokan "persis" tergantung platform: sistem file Windows tidak peka huruf besar/kecil, sehingga pola "ABC" akan cocok dengan file yang disebut "abc". Pada sistem file peka huruf besar/kecil, pola dan nama tersebut tidak akan cocok.

Karakter berikut memiliki perilaku khusus.

  • * cocok dengan nol karakter atau lebih dalam nama file atau direktori. Lihat contoh.
  • ? cocok dengan satu karakter dalam nama file atau direktori. Lihat contoh.
  • [] cocok dengan set atau rentang karakter dalam nama file atau direktori. Lihat contoh.
  • ** kartubebas rekursif. Misalnya, /hello/**/* cocok dengan semua turunan /hello.

Perpanjangan globbing

  • ?(hello|world) - kecocokan hello atau world nol kali atau satu kali
  • *(hello|world) - nol atau lebih kemunculan
  • +(hello|world) - satu atau beberapa kemunculan
  • @(hello|world) - tepat sekali
  • !(hello|world) - bukan hello atau world

Nota

Glob yang diperluas tidak dapat mencakup pemisah direktori. Misalnya, +(hello/world|other) tidak valid.

Komentar

Pola yang dimulai dengan # diperlakukan sebagai komentar.

Mengecualikan pola

Leading ! mengubah arti pola yang disertakan untuk dikecualikan. Anda dapat menyertakan pola, mengecualikan subsetnya, lalu menyertakan kembali subsetnya: ini dikenal sebagai pola "terjalin".

Beberapa ! membalikkan arti. Lihat contoh.

Anda harus menentukan pola sertakan sebelum pola pengecualian. Lihat contoh.

Melarikan diri

Membungkus karakter khusus dalam [] dapat digunakan untuk melepaskan karakter glob harfiah dalam nama file. Misalnya nama file harfiah hello[a-z] dapat diloloskan sebagai hello[[]a-z].

Potong

/ digunakan sebagai pemisah jalur di Linux dan macOS. Sebagian besar waktu, agen Windows menerima /. Kesempatan di mana pemisah Windows (\) harus digunakan didokumenkan.

Contoh

Contoh pola dasar

Contoh tanda bintang

Contoh 1: Mengingat pola *Website.sln, dan file berikut:

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

Pola akan cocok:

ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

Contoh 2: Mengingat *Website/*.proj pola dan jalur:

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

Pola akan cocok:

ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/FabrikamWebsite.proj

Contoh tanda tanya

Contoh 1: Mengingat pola log?.log, dan file berikut:

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

Pola akan cocok:

log1.log
log2.log
log3.log

Contoh 2: Mengingat pola image.???, dan file berikut:

image.tiff
image.png
image.ico

Pola akan cocok:

image.png
image.ico

Contoh set karakter

Contoh 1: Mengingat pola Sample[AC].dat, dan file berikut:

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

Pola akan cocok:

SampleA.dat
SampleC.dat

Contoh 2: Mengingat pola Sample[A-C].dat, dan file berikut:

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

Pola akan cocok:

SampleA.dat
SampleB.dat
SampleC.dat

Contoh 3: Mengingat pola Sample[A-CEG].dat, dan file berikut:

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

Pola akan cocok:

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

Contoh kartubebas rekursif

Mengingat pola **/*.ext, dan file berikut:

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

Pola akan cocok:

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

Contoh berikut dihasilkan oleh Copilot. Copilot didukung oleh AI, sehingga kejutan dan kesalahan dimungkinkan. Untuk informasi selengkapnya, lihat FAQ umum untuk Copilot.

Pola **/*.ext glob adalah pola rekursif yang kuat yang digunakan dalam banyak sistem file dan alat (seperti bash, , zsh, Python globdll.) untuk mencocokkan semua file yang berakhiran .ext di direktori saat ini dan semua subdirektori, tidak peduli seberapa dalam bersarang.

Berikut adalah beberapa contoh jalur yang cocok **/*.extdengan :

  • sample1/A.ext
  • sample1/B.ext
  • sample2/C.ext
  • sample2/subdir1/D.ext
  • sample2/subdir1/subdir2/E.ext
  • sample3/F.ext
  • sample3/subdir3/G.ext
  • sample3/subdir3/subdir4/H.ext

Bagian ini ** berarti sejumlah direktori (termasuk nol), dan *.ext berarti file apa pun yang berakhiran .ext.

Mengecualikan contoh pola

Mengingat pola berikut, dan file berikut:

*
!*.xml

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

Pola akan cocok:

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

Contoh pengecualian ganda

Mengingat pola berikut, dan file berikut:

*
!*.xml
!!Fabrikam.xml

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

Pola akan cocok:

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

Contoh pengecualian folder

Mengingat pola berikut, dan file berikut:

**
!sample/**

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

Pola akan cocok:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
  • Last updated on