{"id":2344,"date":"2015-11-05T11:35:21","date_gmt":"2015-11-05T11:35:21","guid":{"rendered":"http:\/\/blog.designed79.co.uk\/?p=2344"},"modified":"2015-11-05T11:35:21","modified_gmt":"2015-11-05T11:35:21","slug":"matching-numeric-ranges-with-a-regular-expression","status":"publish","type":"post","link":"https:\/\/blog.designed79.co.uk\/?p=2344","title":{"rendered":"Matching Numeric Ranges with a Regular Expression"},"content":{"rendered":"

Since\u00a0regular expressions<\/a>\u00a0deal with text rather than with numbers, matching a number in a given range takes a little extra care. You can’t just write\u00a0[0-255]<\/tt>\u00a0to match a number between 0 and 255. Though a valid regex, it matches something entirely different.\u00a0[0-255]<\/tt>\u00a0is a\u00a0character class<\/a>\u00a0with three elements: the character range 0-2, the character 5 and the character 5 (again). This character class matches a single digit 0, 1, 2 or 5, just like\u00a0[0125]<\/tt>.<\/p>\n

Since regular expressions work with text, a regular expression engine treats\u00a00<\/tt>\u00a0as a single character, and\u00a0255<\/tt>\u00a0as three characters. To match all characters from 0 to 255, we’ll need a regex that matches between one and three characters.<\/p>\n

The regex\u00a0[0-9]<\/tt>\u00a0matches single-digit numbers 0 to 9.\u00a0[1-9][0-9]<\/tt>\u00a0matches double-digit numbers 10 to 99. That’s the easy part.<\/p>\n

Matching the three-digit numbers is a little more complicated, since we need to exclude numbers 256 through 999.\u00a01[0-9][0-9]<\/tt>\u00a0takes care of 100 to 199.\u00a02[0-4][0-9]<\/tt>\u00a0matches 200 through 249. Finally,\u00a025[0-5]<\/tt>\u00a0adds 250 till 255.<\/p>\n

As you can see, you need to split up the numeric range in ranges with the same number of digits, and each of those ranges that allow the same variation for each digit. In the 3-digit range in our example, numbers starting with 1 allow all 10 digits for the following two digits, while numbers starting with 2 restrict the digits that are allowed to follow.<\/p>\n

Putting this all together using\u00a0alternation<\/a>\u00a0we get:\u00a0[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5]<\/tt>. This matches the numbers we want, with one caveat: regular expression searches usually allow partial matches, so our regex would match\u00a0123<\/tt>\u00a0in\u00a012345<\/tt>. There are two solutions to this.<\/p>\n

If you’re searching for these numbers in a larger document or input string, use\u00a0word boundaries<\/a>\u00a0to require a non-word character (or no character at all) to precede and to follow any valid match. The regex then becomes\u00a0\\b([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\\b<\/tt>. Since the alternation operator has the lowest precedence of all, the\u00a0parentheses<\/a>\u00a0are required to group the alternatives together. This way the regex engine will try to match the first word boundary, then try all the alternatives, and then try to match the second word boundary after the numbers it matched. Regular expression engines consider all alphanumeric characters, as well as the underscore, as word characters.<\/p>\n

If you’re using the regular expression to validate input, you’ll probably want to check that the entire input consists of a valid number. To do this, replace the word boundaries with\u00a0anchors<\/a>\u00a0to match the start and end of the string:\u00a0^([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$<\/tt>.<\/p>\n

Here are a few more common ranges that you may want to match:<\/p>\n