117

I have a version number of the following form:

version.release.modification

where version, release and modification are either a set of digits or the '*' wildcard character. Additionally, any of these numbers (and any preceding .) may be missing.

So the following are valid and parse as:

1.23.456 = version 1, release 23, modification 456
1.23     = version 1, release 23, any modification
1.23.*   = version 1, release 23, any modification
1.*      = version 1, any release, any modification
1        = version 1, any release, any modification
*        = any version, any release, any modification

But these are not valid:

*.12
*123.1
12*
12.*.34

Can anyone provide me a not-too-complex regex to validate and retrieve the release, version and modification numbers?

Andrew Borley
  • 1,684
  • 2
  • 11
  • 13

24 Answers24

136

I'd express the format as:

"1-3 dot-separated components, each numeric except that the last one may be *"

As a regexp, that's:

^(\d+\.)?(\d+\.)?(\*|\d+)$

[Edit to add: this solution is a concise way to validate, but it has been pointed out that extracting the values requires extra work. It's a matter of taste whether to deal with this by complicating the regexp, or by processing the matched groups.

In my solution, the groups capture the "." characters. This can be dealt with using non-capturing groups as in ajborley's answer.

Also, the rightmost group will capture the last component, even if there are fewer than three components, and so for example a two-component input results in the first and last groups capturing and the middle one undefined. I think this can be dealt with by non-greedy groups where supported.

Perl code to deal with both issues after the regexp could be something like this:

@version = ();
@groups = ($1, $2, $3);
foreach (@groups) {
    next if !defined;
    s/\.//;
    push @version, $_;
}
($major, $minor, $mod) = (@version, "*", "*");

Which isn't really any shorter than splitting on "." ]

Alexander Taylor
  • 16,574
  • 14
  • 62
  • 83
Steve Jessop
  • 273,490
  • 39
  • 460
  • 699
  • 1
    Adding some non-capturing groups (see my answer below) means that the capturing groups don't capture the trailing '.' ^(?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)$ Thanks! – Andrew Borley Sep 17 '08 at 12:15
  • The only problem with that one - being a very nice and clean proposal - is that the groups are not right because 1.2 will capture 1 in the first and 2 in the third group because of greedyness. – jrudolph Sep 17 '08 at 12:16
  • To avoid what @jrudolph pointed out, just move the dots ('.') to the next capturing group `^(?:(\d+))(?:\.(\d+))?(?:\.(\*|\d+))?$` – Ryan M May 24 '22 at 21:26
43

Use regex and now you have two problems. I would split the thing on dots ("."), then make sure that each part is either a wildcard or set of digits (regex is perfect now). If the thing is valid, you just return correct chunk of the split.

Paweł Hajdan
  • 18,074
  • 9
  • 49
  • 65
17

Thanks for all the responses! This is ace :)

Based on OneByOne's answer (which looked the simplest to me), I added some non-capturing groups (the '(?:' parts - thanks to VonC for introducing me to non-capturing groups!), so the groups that do capture only contain the digits or * character.

^(?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)$

Many thanks everyone!

Andrew Borley
  • 1,684
  • 2
  • 11
  • 13
  • 2
    Could you add this as an edit to your question instead? That way the right answers is close to the top – svrist Sep 17 '08 at 12:25
  • 1
    With group names: ^(?:(?\d+)\.)?(?:(? \d+)\.)?(?\*|\d+)$ – javacavaj May 19 '14 at 21:16
  • 1
    support semversion (a bit more). - "1.2.3-alpha+abcdedf.lalal" -match "^(?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)?(?:\-([A-Za-z0-9\.]+))?(?:\+([A-Za-z0-9\.]+))?$" – Sam Jul 11 '16 at 07:34
  • Beware that in case of a version consisting from a single number it will be matched by the third `(\*|\d+)` not the first `^(?:(\d+)\.)?` group. – Piotr Dobrogost Mar 20 '19 at 11:28
15

This might work:

^(\*|\d+(\.\d+){0,2}(\.\*)?)$

At the top level, "*" is a special case of a valid version number. Otherwise, it starts with a number. Then there are zero, one, or two ".nn" sequences, followed by an optional ".*". This regex would accept 1.2.3.* which may or may not be permitted in your application.

The code for retrieving the matched sequences, especially the (\.\d+){0,2} part, will depend on your particular regex library.

Greg Hewgill
  • 951,095
  • 183
  • 1,149
  • 1,285
  • Great answer! I think you should swap the unescaped * for {0,2} to prevent 1.2.3.4 matching. Depending on your regexp library you may want to enclose the pattern in ^()$ if you can only do a search rather than a match. – David Webb Sep 17 '08 at 11:29
  • Slight alteration to ^(\*|\d+(\.\d+){0,1}(?:(\.\*)?|(\.\d+)?))$ would invalidate 1.2.3.* too – Pieter Sep 17 '08 at 11:47
  • 2
    Pieter: I think I'm going to stop where I am for now. This is quickly getting into "now you have two problems" territory. :) – Greg Hewgill Sep 17 '08 at 11:49
13

My 2 cents: I had this scenario: I had to parse version numbers out of a string literal. (I know this is very different from the original question, but googling to find a regex for parsing version number showed this thread at the top, so adding this answer here)

So the string literal would be something like: "Service version 1.2.35.564 is running!"

I had to parse the 1.2.35.564 out of this literal. Taking a cue from @ajborley, my regex is as follows:

(?:(\d+)\.)?(?:(\d+)\.)?(?:(\d+)\.\d+)

A small C# snippet to test this looks like below:

void Main()
{
    Regex regEx = new Regex(@"(?:(\d+)\.)?(?:(\d+)\.)?(?:(\d+)\.\d+)", RegexOptions.Compiled);

    Match version = regEx.Match("The Service SuperService 2.1.309.0) is Running!");
    version.Value.Dump("Version using RegEx");   // Prints 2.1.309.0        
}
Sudhanshu Mishra
  • 6,523
  • 2
  • 59
  • 76
  • I know you're describing an alternative situation and case, but just to be complete: SemVer 'requires' the version string to be of the format `X.Y.Z` (so, exactly three parts), where X and Y must be non-negative integers and no additional leading zeros. See http://semver.org/. – Jochem Schulenklopper Mar 14 '17 at 13:53
  • 1
    @JochemSchulenklopper thanks, I'm aware of SemVer, although the question does not mention anything about SemVer. – Sudhanshu Mishra Mar 14 '17 at 22:45
  • 1
    True. I was referred to this question by a colleague about parsing SemVer strings, so that framed my reading of the answers. – Jochem Schulenklopper Mar 15 '17 at 09:25
12

I had a requirement to search/match for version numbers, that follows maven convention or even just single digit. But no qualifier in any case. It was peculiar, it took me time then I came up with this:

'^[0-9][0-9.]*$'

This makes sure the version,

  1. Starts with a digit
  2. Can have any number of digit
  3. Only digits and '.' are allowed

One drawback is that version can even end with '.' But it can handle indefinite length of version (crazy versioning if you want to call it that)

Matches:

  • 1.2.3
  • 1.09.5
  • 3.4.4.5.7.8.8.
  • 23.6.209.234.3

If you are not unhappy with '.' ending, may be you can combine with endswith logic

Shiva
  • 717
  • 9
  • 22
8

Don't know what platform you're on but in .NET there's the System.Version class that will parse "n.n.n.n" version numbers for you.

Duncan Smart
  • 31,172
  • 10
  • 68
  • 70
7

I've seen a lot of answers, but... i have a new one. It works for me at least. I've added a new restriction. Version numbers can't start (major, minor or patch) with any zeros followed by others.

01.0.0 is not valid 1.0.0 is valid 10.0.10 is valid 1.0.0000 is not valid

^(?:(0\\.|([1-9]+\\d*)\\.))+(?:(0\\.|([1-9]+\\d*)\\.))+((0|([1-9]+\\d*)))$

It's based in a previous one. But i see this solution better... for me ;)

Enjoy!!!

ajitksharma
  • 4,523
  • 2
  • 21
  • 40
Israel Romero
  • 31
  • 1
  • 2
7
^(?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)$

Perhaps a more concise one could be :

^(?:(\d+)\.){0,2}(\*|\d+)$

This can then be enhanced to 1.2.3.4.5.* or restricted exactly to X.Y.Z using * or {2} instead of {0,2}

ofaurax
  • 1,417
  • 1
  • 20
  • 27
6

I tend to agree with split suggestion.

Ive created a "tester" for your problem in perl

#!/usr/bin/perl -w


@strings = ( "1.2.3", "1.2.*", "1.*","*" );

%regexp = ( svrist => qr/(?:(\d+)\.(\d+)\.(\d+)|(\d+)\.(\d+)|(\d+))?(?:\.\*)?/,
            onebyone => qr/^(\d+\.)?(\d+\.)?(\*|\d+)$/,
            greg => qr/^(\*|\d+(\.\d+){0,2}(\.\*)?)$/,
            vonc => qr/^((?:\d+(?!\.\*)\.)+)(\d+)?(\.\*)?$|^(\d+)\.\*$|^(\*|\d+)$/,
            ajb => qr/^(?:(\d+)\.)?(?:(\d+)\.)?(\*|\d+)$/,
            jrudolph => qr/^(((\d+)\.)?(\d+)\.)?(\d+|\*)$/
          );

  foreach my $r (keys %regexp){
    my $reg = $regexp{$r};
    print "Using $r regexp\n";
foreach my $s (@strings){
  print "$s : ";

    if ($s =~m/$reg/){
    my ($main, $maj, $min,$rev,$ex1,$ex2,$ex3) = ("any","any","any","any","any","any","any");
    $main = $1 if ($1 && $1 ne "*") ;
    $maj = $2 if ($2 && $2 ne "*") ;
    $min = $3 if ($3 && $3 ne "*") ;
    $rev = $4 if ($4 && $4 ne "*") ;
    $ex1 = $5 if ($5 && $5 ne "*") ;
    $ex2 = $6 if ($6 && $6 ne "*") ;
    $ex3 = $7 if ($7 && $7 ne "*") ;
    print "$main $maj $min $rev $ex1 $ex2 $ex3\n";

  }else{
  print " nomatch\n";
  }
  }
print "------------------------\n";
}

Current output:

> perl regex.pl
Using onebyone regexp
1.2.3 : 1. 2. 3 any any any any
1.2.* : 1. 2. any any any any any
1.* : 1. any any any any any any
* : any any any any any any any
------------------------
Using svrist regexp
1.2.3 : 1 2 3 any any any any
1.2.* : any any any 1 2 any any
1.* : any any any any any 1 any
* : any any any any any any any
------------------------
Using vonc regexp
1.2.3 : 1.2. 3 any any any any any
1.2.* : 1. 2 .* any any any any
1.* : any any any 1 any any any
* : any any any any any any any
------------------------
Using ajb regexp
1.2.3 : 1 2 3 any any any any
1.2.* : 1 2 any any any any any
1.* : 1 any any any any any any
* : any any any any any any any
------------------------
Using jrudolph regexp
1.2.3 : 1.2. 1. 1 2 3 any any
1.2.* : 1.2. 1. 1 2 any any any
1.* : 1. any any 1 any any any
* : any any any any any any any
------------------------
Using greg regexp
1.2.3 : 1.2.3 .3 any any any any any
1.2.* : 1.2.* .2 .* any any any any
1.* : 1.* any .* any any any any
* : any any any any any any any
------------------------
svrist
  • 7,042
  • 7
  • 44
  • 67
5

This should work for what you stipulated. It hinges on the wild card position and is a nested regex:

^((\*)|([0-9]+(\.((\*)|([0-9]+(\.((\*)|([0-9]+)))?)))?))$

http://imgur.com/3E492.png

Emre Erkan
  • 8,433
  • 3
  • 48
  • 53
nomuus
  • 81
  • 1
  • 2
5

For parsing version numbers that follow these rules: - Are only digits and dots - Cannot start or end with a dot - Cannot be two dots together

This one did the trick to me.

^(\d+)((\.{1}\d+)*)(\.{0})$

Valid cases are:

1, 0.1, 1.2.1

Pau Ballada
  • 1,491
  • 14
  • 13
4

My take on this, as a good exercise - vparse, which has a tiny source, with a simple function:

function parseVersion(v) {
    var m = v.match(/\d*\.|\d+/g) || [];
    v = {
        major: +m[0] || 0,
        minor: +m[1] || 0,
        patch: +m[2] || 0,
        build: +m[3] || 0
    };
    v.isEmpty = !v.major && !v.minor && !v.patch && !v.build;
    v.parsed = [v.major, v.minor, v.patch, v.build];
    v.text = v.parsed.join('.');
    return v;
}
vitaly-t
  • 24,279
  • 15
  • 116
  • 138
4

Sometimes version numbers might contain alphanumeric minor information (e.g. 1.2.0b or 1.2.0-beta). In this case I am using this regex:

([0-9]{1,4}(\.[0-9a-z]{1,6}){1,5})
Marc Ruef
  • 3,251
  • 1
  • 11
  • 13
4

Another try:

^(((\d+)\.)?(\d+)\.)?(\d+|\*)$

This gives the three parts in groups 4,5,6 BUT: They are aligned to the right. So the first non-null one of 4,5 or 6 gives the version field.

  • 1.2.3 gives 1,2,3
  • 1.2.* gives 1,2,*
  • 1.2 gives null,1,2
  • *** gives null,null,*
  • 1.* gives null,1,*
jrudolph
  • 8,307
  • 4
  • 32
  • 50
3

Specifying XSD elements:

<xs:simpleType>
    <xs:restriction base="xs:string">
        <xs:pattern value="[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}(\..*)?"/>
    </xs:restriction>
</xs:simpleType>
Emmerson
  • 61
  • 3
3

Keep in mind regexp are greedy, so if you are just searching within the version number string and not within a bigger text, use ^ and $ to mark start and end of your string. The regexp from Greg seems to work fine (just gave it a quick try in my editor), but depending on your library/language the first part can still match the "*" within the wrong version numbers. Maybe I am missing something, as I haven't used Regexp for a year or so.

This should make sure you can only find correct version numbers:

^(\*|\d+(\.\d+)*(\.\*)?)$

edit: actually greg added them already and even improved his solution, I am too slow :)

FrankS
  • 2,374
  • 3
  • 26
  • 32
3
(?ms)^((?:\d+(?!\.\*)\.)+)(\d+)?(\.\*)?$|^(\d+)\.\*$|^(\*|\d+)$

Does exactly match your 6 first examples, and rejects the 4 others

  • group 1: major or major.minor or '*'
  • group 2 if exists: minor or *
  • group 3 if exists: *

You can remove '(?ms)'
I used it to indicate to this regexp to be applied on multi-lines through QuickRex

VonC
  • 1,262,500
  • 529
  • 4,410
  • 5,250
3

This matches 1.2.3.* too

^(*|\d+(.\d+){0,2}(.*)?)$

I would propose the less elegant:

(*|\d+(.\d+)?(.*)?)|\d+.\d+.\d+)

Victor
  • 9,210
  • 3
  • 26
  • 39
3

It seems pretty hard to have a regex that does exactly what you want (i.e. accept only the cases that you need and reject all others and return some groups for the three components). I've give it a try and come up with this:

^(\*|(\d+(\.(\d+(\.(\d+|\*))?|\*))?))$

IMO (I've not tested extensively) this should work fine as a validator for the input, but the problem is that this regex doesn't offer a way of retrieving the components. For that you still have to do a split on period.

This solution is not all-in-one, but most times in programming it doesn't need to. Of course this depends on other restrictions that you might have in your code.

rslite
  • 81,705
  • 4
  • 44
  • 47
2

One more solution:

^[1-9][\d]*(.[1-9][\d]*)*(.\*)?|\*$
Oleksandr Yarushevskyi
  • 2,789
  • 2
  • 17
  • 24
1

I found this, and it works for me:

/(\^|\~?)(\d|x|\*)+\.(\d|x|\*)+\.(\d|x|\*)+
Or Assayag
  • 5,662
  • 13
  • 57
  • 93
1
/^([1-9]{1}\d{0,3})(\.)([0-9]|[1-9]\d{1,3})(\.)([0-9]|[1-9]\d{1,3})(\-(alpha|beta|rc|HP|CP|SP|hp|cp|sp)[1-9]\d*)?(\.C[0-9a-zA-Z]+(-U[1-9]\d*)?)?(\.[0-9a-zA-Z]+)?$/
  • A normal version: ([1-9]{1}\d{0,3})(\.)([0-9]|[1-9]\d{1,3})(\.)([0-9]|[1-9]\d{1,3})
  • A Pre-release or patched version: (\-(alpha|beta|rc|EP|HP|CP|SP|ep|hp|cp|sp)[1-9]\d*)? (Extension Pack, Hotfix Pack, Coolfix Pack, Service Pack)
  • Customized version: (\.C[0-9a-zA-Z]+(-U[1-9]\d*)?)?
  • Internal version: (\.[0-9a-zA-Z]+)?

enter image description here

山茶树和葡萄树
  • 2,050
  • 1
  • 18
  • 18
0

This works for me:

^(-?\d+)\.(-?\d+)\.(-?\d+)$
Adrian Mole
  • 49,934
  • 160
  • 51
  • 83
  • According to [semver.org](https://semver.org/#spec-item-2), "A normal version number MUST take the form X.Y.Z where X, Y, and Z are _non-negative_ integers" (my italics) so I don't think this is correct. – snakecharmerb Aug 29 '23 at 15:26
  • Your answer could be improved with additional supporting information. Please [edit] to add further details, such as citations or documentation, so that others can confirm that your answer is correct. You can find more information on how to write good answers [in the help center](/help/how-to-answer). – Community Aug 31 '23 at 17:43
  • @snakecharmerb you are entirely correct. Thank you! I'll try to fix the expression. – Antonio Iliev Sep 01 '23 at 14:52