118

I have to admit that I always forgot the syntactical intracacies of the naming patterns for Nant (eg. those used in filesets). The double asterisk/single asterisk stuff seems to be very forgettable in my mind.

Can someone provide a definitive guide to the naming patterns?

2
  • 3
    I have read the reference. And re-read it. And re-read it. I just think it has a really poor set of examples and is unclear in its message.
    – berko
    Sep 17, 2008 at 0:12
  • Maybe you can specify exactly what you're trying to achive and someone can provide a better answer? Sep 17, 2008 at 12:34

4 Answers 4

284

The rules are:

  • a single star (*) matches zero or more characters within a path name
  • a double star (**) matches zero or more characters across directory levels
  • a question mark (?) matches exactly one character within a path name

Another way to think about it is double star (**) matches slash (/) but single star (*) does not.

Let's say you have the files:

  1. bar.txt
  2. src/bar.c
  3. src/baz.c
  4. src/test/bartest.c

Then the patterns:

  • *.c             matches nothing (there are no .c files in the current directory)
  • src/*.c     matches 2 and 3
  • */*.c         matches 2 and 3 (because * only matches one level)
  • **/*.c       matches 2, 3, and 4 (because ** matches any number of levels)
  • bar.*         matches 1
  • **/bar.*   matches 1 and 2
  • **/bar*.* matches 1, 2, and 4
  • src/ba?.c matches 2 and 3    
10
  • 8
    I think that this is a much better explanation than the Nant reference. Cheers!
    – berko
    Sep 18, 2008 at 9:41
  • 1
    What does src/*/** match? I would expect it to be 4, but my experience with maven seems to indicate that you match any files in any folders you need src/*/*/** Apr 2, 2013 at 16:43
  • 3
    what would **.c match?
    – chharvey
    May 23, 2015 at 3:01
  • 3
    I don't use Ant any more, so I'm not in a place to answer follow-up questions. You should ask a new question or, even better, find the answer and then submit an edit to my answer.
    – benzado
    Jun 3, 2015 at 17:01
  • 1
    @sitaktif One way to think about it is that bar.txt is implicitly ./bar.txt (. means the current directory). So that list is really ./bar.txt, ./src/bar.c, etc. and the ./ is assumed.
    – benzado
    Sep 29, 2016 at 15:28
22

Here's a few extra pattern matches which are not so obvious from the documentation. Tested using NAnt for the example files in benzado's answer:

  1. bar.txt
  2. src/bar.c
  3. src/baz.c
  4. src/test/bartest.c
  • src**                      matches 2, 3 and 4
  • **.c                        matches 2, 3, and 4
  • **ar.*                    matches 1 and 2
  • **/bartest.c/**  matches 4
  • src/ba?.c/**        matches 2 and 3
1
  • 3
    small note: with ant (1.8.2) **.c is no replacement for **/*.c
    – nonsenz
    Oct 14, 2013 at 8:20
5

Double asterisks (**) are associated with the folder-names matching, whereas single symbols asterisk (* = multi characters) as well as the question-mark (? = single character) are used to match the file-names.

4

Check out the Nant reference. The fileset patterns are:

'*' matches zero or more characters, e.g. *.cs
'?' matches one character, e.g. ?.cs

And '**' matches a directory tree e.g. src/**/*.cs will find all cs files in any sub-directory of src.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.