1045

How would you check if a String was a number before parsing it?

6
  • 42
    All the solutions proposed with regular expresions will not work for hexadecimal numbers. Feb 17, 2012 at 12:52
  • and passing null string in matches(...) function will throw NullPointer exception. Apr 14, 2016 at 7:31
  • See Max Malysh's answer for a concise Java 8 solution without third-party libraries. Apr 28, 2016 at 19:50
  • @HiteshSahu null strings seem to be gracefully handled in latest version (including Java 6.x and 7.x) Oct 6, 2016 at 6:27
  • All the solutions proposed to use Integer.parseInt() will fail to parse mobile numbers with NumberFormatException.
    – Not a bug
    Mar 16, 2017 at 7:24

41 Answers 41

1030

This is generally done with a simple user-defined function (i.e. Roll-your-own "isNumeric" function).

Something like:

public static boolean isNumeric(String str) { 
  try {  
    Double.parseDouble(str);  
    return true;
  } catch(NumberFormatException e){  
    return false;  
  }  
}

However, if you're calling this function a lot, and you expect many of the checks to fail due to not being a number then performance of this mechanism will not be great, since you're relying upon exceptions being thrown for each failure, which is a fairly expensive operation.

An alternative approach may be to use a regular expression to check for validity of being a number:

public static boolean isNumeric(String str) {
  return str.matches("-?\\d+(\\.\\d+)?");  //match a number with optional '-' and decimal.
}

Be careful with the above RegEx mechanism, though, as it will fail if you're using non-Arabic digits (i.e. numerals other than 0 through to 9). This is because the "\d" part of the RegEx will only match [0-9] and effectively isn't internationally numerically aware. (Thanks to OregonGhost for pointing this out!)

Or even another alternative is to use Java's built-in java.text.NumberFormat object to see if, after parsing the string the parser position is at the end of the string. If it is, we can assume the entire string is numeric:

public static boolean isNumeric(String str) {
  ParsePosition pos = new ParsePosition(0);
  NumberFormat.getInstance().parse(str, pos);
  return str.length() == pos.getIndex();
}
23
  • 8
    Does \d in Java Regex match only latin digits? If it's like .NET regexes, you'll run into a problem with other (e.g. arabic) digits, as explained here: blogs.msdn.com/oldnewthing/archive/2004/03/09/86555.aspx Jul 9, 2009 at 10:07
  • 3
    the numberFormatter solution is probably only marginally better than catching the NumberFormatException one. I suspect the best way is to use regex one.
    – Chii
    Jul 9, 2009 at 11:22
  • 12
    Note that the . in your regex will match any character, not just the decimal separator character.
    – jqno
    Jul 11, 2009 at 8:16
  • 9
    +1 for realizing the expense of try/catch. This is actually a horrible approach to use in the long run for repeated use, but really we are stuck with that in Java.
    – demongolem
    Sep 6, 2011 at 15:20
  • 11
    Note that there are no such things as "latin numerals", and the numerals 0-9 are in fact Arabic numerals. People are probably familar with Roman numerals, which were used by people who spoke Latin, in the form I, II, III, IV, V, VI, etc. en.wikipedia.org/wiki/Arabic_numerals; en.wikipedia.org/wiki/Roman_numerals
    – dantiston
    Mar 5, 2016 at 0:26
781

With Apache Commons Lang 3.5 and above: NumberUtils.isCreatable or StringUtils.isNumeric.

With Apache Commons Lang 3.4 and below: NumberUtils.isNumber or StringUtils.isNumeric.

You can also use StringUtils.isNumericSpace which returns true for empty strings and ignores internal spaces in the string. Another way is to use NumberUtils.isParsable which basically checks the number is parsable according to Java. (The linked javadocs contain detailed examples for each method.)

14
  • 70
    StringUtils.isNumeric() probably wouldn't be appropriate here since it only checks if the string is a sequence of digits. Would be fine for most ints but not so for numbers with decimals, group separators, etc. Feb 8, 2013 at 23:19
  • 49
    reinvent the wheel because you don't include a whole library because you need a 3 line function in one place. Sep 18, 2014 at 12:34
  • 17
    Is it really worth adding a whole library for this feature though? Obviously if it's used with other stuff that's great, but it's probably overkill considering people have solved this in one line of code.
    – Water
    Mar 30, 2015 at 0:47
  • 7
    Doesn't work with negatives. And half of all numbers are negative, so..... Jun 30, 2017 at 16:58
  • 8
    @PaulDraper: You're right, StringUtils does not support leading signs but you should check NumberUtils.isCreatable, it supports negatives properly.
    – palacsint
    Jul 1, 2017 at 19:03
195

Java 8 lambda expressions.

String someString = "123123";
boolean isNumeric = someString.chars().allMatch( Character::isDigit );
9
  • 4
    You can use a method reference, too: someString.chars().allMatch(Character::isDigit)
    – Wienczny
    Feb 8, 2016 at 17:35
  • 3
    Nice but still it's reinventing the wheel as almost all "solutions" here. Also, fails on 'null' (as almost all the others).
    – qben
    Mar 24, 2016 at 10:03
  • 11
    This answer is concise, simple and readable. You can almost read it like English -- "chars all match digits". It requires no third-party libraries. It does not use exceptions in non-exceptional cases. This should become the accepted answer. Apr 28, 2016 at 20:02
  • 24
    What will it produce for "-1"? Jun 28, 2016 at 13:32
  • 11
    Not the right answer. A numeric string can have non-numeric characters (ex. "." or "-") and still be perfectly numerical. For example 0.5, -1, and 1,000 will all fail with this answer and yet they are perfectly numerical.
    – Simeon G
    Apr 24, 2018 at 18:24
172

if you are on android, then you should use:

android.text.TextUtils.isDigitsOnly(CharSequence str)

documentation can be found here

keep it simple. mostly everybody can "re-program" (the same thing).

5
  • 5
    @kape123 :) sure "123.456" doesn´t contain digits. Nov 14, 2014 at 18:01
  • 10
    Note: this results in NPE for null input. Also, doesn't work with negative numbers or decimals.
    – gMale
    Dec 19, 2014 at 17:36
  • 2
    I like it!! I think this is absolutely for digits. Not for ., -
    – illusionJJ
    Sep 13, 2016 at 3:29
  • 1
    This is just what I was looking for. Something simple to check for only digits 0-9. I set a filter in the declaration of my EditText but just in case that get's changed or replaced down the road it's nice to have a simple programmatic check as well.
    – jwehrle
    Jun 26, 2018 at 18:59
  • Why this method returns true for empty strings?
    – YaMiN
    Oct 9, 2021 at 19:32
134

As @CraigTP had mentioned in his excellent answer, I also have similar performance concerns on using Exceptions to test whether the string is numerical or not. So I end up splitting the string and use java.lang.Character.isDigit().

public static boolean isNumeric(String str)
{
    for (char c : str.toCharArray())
    {
        if (!Character.isDigit(c)) return false;
    }
    return true;
}

According to the Javadoc, Character.isDigit(char) will correctly recognizes non-Latin digits. Performance-wise, I think a simple N number of comparisons where N is the number of characters in the string would be more computationally efficient than doing a regex matching.

UPDATE: As pointed by Jean-François Corbett in the comment, the above code would only validate positive integers, which covers the majority of my use case. Below is the updated code that correctly validates decimal numbers according to the default locale used in your system, with the assumption that decimal separator only occur once in the string.

public static boolean isStringNumeric( String str )
{
    DecimalFormatSymbols currentLocaleSymbols = DecimalFormatSymbols.getInstance();
    char localeMinusSign = currentLocaleSymbols.getMinusSign();

    if ( !Character.isDigit( str.charAt( 0 ) ) && str.charAt( 0 ) != localeMinusSign ) return false;

    boolean isDecimalSeparatorFound = false;
    char localeDecimalSeparator = currentLocaleSymbols.getDecimalSeparator();

    for ( char c : str.substring( 1 ).toCharArray() )
    {
        if ( !Character.isDigit( c ) )
        {
            if ( c == localeDecimalSeparator && !isDecimalSeparatorFound )
            {
                isDecimalSeparatorFound = true;
                continue;
            }
            return false;
        }
    }
    return true;
}
5
  • 2
    Does -ve sign fail this function?
    – java_mouse
    May 29, 2013 at 14:14
  • 1
    I think this should be the accepted answer because it is the lightest solution. Using an exception or a regex are both really heavy to check if a string is numeric. Iterating over the characters is nice and simple!
    – W.K.S
    Dec 1, 2013 at 10:22
  • 1
    The above code accepts a single '-' as numeric and will return true. change first if to something like: boolean isMinus = str.charAt(0) == localeMinusSign; if ((isMinus && str.length() < 2) || ((!isMinus) && !Character.isDigit(str.charAt(0)))) { return false; }
    – coder
    Dec 25, 2013 at 20:47
  • 3
    Calling toCharArray() will create a copy of the array in the String object because Strings are immutable. Probably faster to use the charAt(int index) method on the String object directly. Oct 8, 2014 at 22:31
  • 2
    Will generate StringIndexOutOfBoundsException when passed a string with length 0. Can be fixed with if(str.length() == 0) return false;
    – samgak
    Feb 25, 2016 at 4:27
44

Google's Guava library provides a nice helper method to do this: Ints.tryParse. You use it like Integer.parseInt but it returns null rather than throw an Exception if the string does not parse to a valid integer. Note that it returns Integer, not int, so you have to convert/autobox it back to int.

Example:

String s1 = "22";
String s2 = "22.2";
Integer oInt1 = Ints.tryParse(s1);
Integer oInt2 = Ints.tryParse(s2);

int i1 = -1;
if (oInt1 != null) {
    i1 = oInt1.intValue();
}
int i2 = -1;
if (oInt2 != null) {
    i2 = oInt2.intValue();
}

System.out.println(i1);  // prints 22
System.out.println(i2);  // prints -1

However, as of the current release -- Guava r11 -- it is still marked @Beta.

I haven't benchmarked it. Looking at the source code there is some overhead from a lot of sanity checking but in the end they use Character.digit(string.charAt(idx)), similar, but slightly different from, the answer from @Ibrahim above. There is no exception handling overhead under the covers in their implementation.

1
  • Beware that this would throw NPE in case argument is null.
    – Vadzim
    Jun 18, 2019 at 11:28
32

Do not use Exceptions to validate your values. Use Util libs instead like apache NumberUtils:

NumberUtils.isNumber(myStringValue);

Edit:

Please notice that, if your string starts with an 0, NumberUtils will interpret your value as hexadecimal.

NumberUtils.isNumber("07") //true
NumberUtils.isNumber("08") //false
4
  • 9
    The accepted answer, three years earlier, already covered Number.isNumber(). Apr 28, 2016 at 19:29
  • I don't think so. It was updated or op changed the accepted answer. I remember the accepted answer didn't covered NumberUtils thats why I added my answer. But thanks for the comment
    – Lama
    Apr 29, 2016 at 7:23
  • 3
    @Goot - The history of the accepted answer shows that Number.isNumber() was present from the first version of the answer, dated Sep 24 '12 at 17:01. Feb 16, 2017 at 18:32
  • @Goot, this is pretty good as it also covers the decimal value check, unlike StringUtils. Feb 2, 2018 at 6:20
29

Why is everyone pushing for exception/regex solutions?

While I can understand most people are fine with using try/catch, if you want to do it frequently... it can be extremely taxing.

What I did here was take the regex, the parseNumber() methods, and the array searching method to see which was the most efficient. This time, I only looked at integer numbers.

public static boolean isNumericRegex(String str) {
    if (str == null)
        return false;
    return str.matches("-?\\d+");
}

public static boolean isNumericArray(String str) {
    if (str == null)
        return false;
    char[] data = str.toCharArray();
    if (data.length <= 0)
        return false;
    int index = 0;
    if (data[0] == '-' && data.length > 1)
        index = 1;
    for (; index < data.length; index++) {
        if (data[index] < '0' || data[index] > '9') // Character.isDigit() can go here too.
            return false;
    }
    return true;
}

public static boolean isNumericException(String str) {
    if (str == null)
        return false;
    try {  
        /* int i = */ Integer.parseInt(str);
    } catch (NumberFormatException nfe) {  
        return false;  
    }
    return true;
}

The results in speed I got were:

Done with: for (int i = 0; i < 10000000; i++)...

With only valid numbers ("59815833" and "-59815833"):
    Array numeric took 395.808192 ms [39.5808192 ns each]
    Regex took 2609.262595 ms [260.9262595 ns each]
    Exception numeric took 428.050207 ms [42.8050207 ns each]
    // Negative sign
    Array numeric took 355.788273 ms [35.5788273 ns each]
    Regex took 2746.278466 ms [274.6278466 ns each]
    Exception numeric took 518.989902 ms [51.8989902 ns each]
    // Single value ("1")
    Array numeric took 317.861267 ms [31.7861267 ns each]
    Regex took 2505.313201 ms [250.5313201 ns each]
    Exception numeric took 239.956955 ms [23.9956955 ns each]
    // With Character.isDigit()
    Array numeric took 400.734616 ms [40.0734616 ns each]
    Regex took 2663.052417 ms [266.3052417 ns each]
    Exception numeric took 401.235906 ms [40.1235906 ns each]

With invalid characters ("5981a5833" and "a"):
    Array numeric took 343.205793 ms [34.3205793 ns each]
    Regex took 2608.739933 ms [260.8739933 ns each]
    Exception numeric took 7317.201775 ms [731.7201775 ns each]
    // With a single character ("a")
    Array numeric took 291.695519 ms [29.1695519 ns each]
    Regex took 2287.25378 ms [228.725378 ns each]
    Exception numeric took 7095.969481 ms [709.5969481 ns each]

With null:
    Array numeric took 214.663834 ms [21.4663834 ns each]
    Regex took 201.395992 ms [20.1395992 ns each]
    Exception numeric took 233.049327 ms [23.3049327 ns each]
    Exception numeric took 6603.669427 ms [660.3669427 ns each] if there is no if/null check

Disclaimer: I'm not claiming these methods are 100% optimized, they're just for demonstration of the data

Exceptions won if and only if the number is 4 characters or less, and every string is always a number... in which case, why even have a check?

In short, it is extremely painful if you run into invalid numbers frequently with the try/catch, which makes sense. An important rule I always follow is NEVER use try/catch for program flow. This is an example why.

Interestingly, the simple if char <0 || >9 was extremely simple to write, easy to remember (and should work in multiple languages) and wins almost all the test scenarios.

The only downside is that I'm guessing Integer.parseInt() might handle non ASCII numbers, whereas the array searching method does not.


For those wondering why I said it's easy to remember the character array one, if you know there's no negative signs, you can easily get away with something condensed as this:

public static boolean isNumericArray(String str) {
    if (str == null)
        return false;
    for (char c : str.toCharArray())
        if (c < '0' || c > '9')
            return false;
    return true;

Lastly as a final note, I was curious about the assigment operator in the accepted example with all the votes up. Adding in the assignment of

double d = Double.parseDouble(...)

is not only useless since you don't even use the value, but it wastes processing time and increased the runtime by a few nanoseconds (which led to a 100-200 ms increase in the tests). I can't see why anyone would do that since it actually is extra work to reduce performance.

You'd think that would be optimized out... though maybe I should check the bytecode and see what the compiler is doing. That doesn't explain why it always showed up as lengthier for me though if it somehow is optimized out... therefore I wonder what's going on. As a note: By lengthier, I mean running the test for 10000000 iterations, and running that program multiple times (10x+) always showed it to be slower.

EDIT: Updated a test for Character.isDigit()

3
  • 5
    Doesn't this compile a new regular expression every time? That doesn't seem very efficient. Jun 11, 2015 at 16:26
  • 1
    @SamuelEdwinWard Thats the whole reason I made this post... the regex example used other people's provided answers and showed how inefficient it is. Even if you attempt regex with pre-compiling it ahead of time and only using that, the time differences are: 2587 ms for the regex I posted from other provided people, 950 ms when compiled ahead of time, 144 ms when doing it as a numeric array (for 1 mil iterations of the same string). Compiling ahead of time obviously would help, but sadly it's still quite inferior to the array way... unless there's some insane optimization I don't know of.
    – Water
    Jun 12, 2015 at 14:26
  • Believing that Regex makes things faster is almost a fallacy. If its a one off search, yeah, I get it... but I have noticed efficiently written code actually outdoes regex enough to shock you! Great post @Water
    – Yo Apps
    Oct 16, 2019 at 16:21
22
public static boolean isNumeric(String str)
{
    return str.matches("-?\\d+(.\\d+)?");
}

CraigTP's regular expression (shown above) produces some false positives. E.g. "23y4" will be counted as a number because '.' matches any character not the decimal point.

Also it will reject any number with a leading '+'

An alternative which avoids these two minor problems is

public static boolean isNumeric(String str)
{
    return str.matches("[+-]?\\d*(\\.\\d+)?");
}
7
  • this will return true for a single plus "+" or minus "-", and false for "0."
    – user85421
    Sep 17, 2011 at 17:16
  • Good catch on the single plus or minus. Is "0." a valid number ?
    – user872985
    Sep 18, 2011 at 8:39
  • "0." is valid for Double.parseDouble() and is a valid literal according the JLS (§3.10.2)!
    – user85421
    Sep 18, 2011 at 15:49
  • Creating a regular expressions is costly as well. The regular expression must be created once and reused Feb 3, 2014 at 18:17
  • 1
    you should change it to matches("-?\\d+([.]\\d+)?")
    – Bob
    Jan 5, 2016 at 13:10
16

We can try replacing all the numbers from the given string with ("") ie blank space and if after that the length of the string is zero then we can say that given string contains only numbers. Example:

boolean isNumber(String str){
        if(str.length() == 0)
            return false; //To check if string is empty
        
        if(str.charAt(0) == '-')
            str = str.replaceFirst("-","");// for handling -ve numbers
    
        System.out.println(str);
        
        str = str.replaceFirst("\\.",""); //to check if it contains more than one decimal points
        
        if(str.length() == 0)
            return false; // to check if it is empty string after removing -ve sign and decimal point
        System.out.println(str);
        
        return str.replaceAll("[0-9]","").length() == 0;
    }
2
  • 1
    So "" is a number but "3.14" and "-1" aren't? Mar 28, 2019 at 12:48
  • 1
    Evidently doesn't apply to all number forms, but here's an upvote for thinking differently...if the original thought was yours, that is. May 28, 2020 at 10:15
15

You can use NumberFormat#parse:

try
{
     NumberFormat.getInstance().parse(value);
}
catch(ParseException e)
{
    // Not a number.
}
5
  • Offered an edit - .getInstance() was missing. +1 as this was the answer I went with when finding this question.
    – 8bitjunkie
    Apr 10, 2012 at 12:45
  • 7
    Costly if used extensibly Feb 3, 2014 at 18:17
  • 1
    It also will pass if there are garbage characters at the end of value. Feb 26, 2014 at 3:11
  • It would create a sonar issue if you don't log the exception
    – jmhostalet
    Apr 12, 2018 at 9:54
  • 1
    This worked for the number format 0x0001 where Double.parseDouble wasn't working. +1
    – Seabass77
    Aug 16, 2018 at 17:41
11

If you using java to develop Android app, you could using TextUtils.isDigitsOnly function.

1
8

Here was my answer to the problem.

A catch all convenience method which you can use to parse any String with any type of parser: isParsable(Object parser, String str). The parser can be a Class or an object. This will also allows you to use custom parsers you've written and should work for ever scenario, eg:

isParsable(Integer.class, "11");
isParsable(Double.class, "11.11");
Object dateFormater = new java.text.SimpleDateFormat("yyyy.MM.dd G 'at' HH:mm:ss z");
isParsable(dateFormater, "2001.07.04 AD at 12:08:56 PDT");

Here's my code complete with method descriptions.

import java.lang.reflect.*;

/**
 * METHOD: isParsable<p><p>
 * 
 * This method will look through the methods of the specified <code>from</code> parameter
 * looking for a public method name starting with "parse" which has only one String
 * parameter.<p>
 * 
 * The <code>parser</code> parameter can be a class or an instantiated object, eg:
 * <code>Integer.class</code> or <code>new Integer(1)</code>. If you use a
 * <code>Class</code> type then only static methods are considered.<p>
 * 
 * When looping through potential methods, it first looks at the <code>Class</code> associated
 * with the <code>parser</code> parameter, then looks through the methods of the parent's class
 * followed by subsequent ancestors, using the first method that matches the criteria specified
 * above.<p>
 * 
 * This method will hide any normal parse exceptions, but throws any exceptions due to
 * programmatic errors, eg: NullPointerExceptions, etc. If you specify a <code>parser</code>
 * parameter which has no matching parse methods, a NoSuchMethodException will be thrown
 * embedded within a RuntimeException.<p><p>
 * 
 * Example:<br>
 * <code>isParsable(Boolean.class, "true");<br>
 * isParsable(Integer.class, "11");<br>
 * isParsable(Double.class, "11.11");<br>
 * Object dateFormater = new java.text.SimpleDateFormat("yyyy.MM.dd G 'at' HH:mm:ss z");<br>
 * isParsable(dateFormater, "2001.07.04 AD at 12:08:56 PDT");<br></code>
 * <p>
 * 
 * @param parser    The Class type or instantiated Object to find a parse method in.
 * @param str   The String you want to parse
 * 
 * @return true if a parse method was found and completed without exception
 * @throws java.lang.NoSuchMethodException If no such method is accessible 
 */
public static boolean isParsable(Object parser, String str) {
    Class theClass = (parser instanceof Class? (Class)parser: parser.getClass());
    boolean staticOnly = (parser == theClass), foundAtLeastOne = false;
    Method[] methods = theClass.getMethods();

    // Loop over methods
    for (int index = 0; index < methods.length; index++) {
        Method method = methods[index];

        // If method starts with parse, is public and has one String parameter.
        // If the parser parameter was a Class, then also ensure the method is static. 
        if(method.getName().startsWith("parse") &&
            (!staticOnly || Modifier.isStatic(method.getModifiers())) &&
            Modifier.isPublic(method.getModifiers()) &&
            method.getGenericParameterTypes().length == 1 &&
            method.getGenericParameterTypes()[0] == String.class)
        {
            try {
                foundAtLeastOne = true;
                method.invoke(parser, str);
                return true; // Successfully parsed without exception
            } catch (Exception exception) {
                // If invoke problem, try a different method
                /*if(!(exception instanceof IllegalArgumentException) &&
                   !(exception instanceof IllegalAccessException) &&
                   !(exception instanceof InvocationTargetException))
                        continue; // Look for other parse methods*/

                // Parse method refuses to parse, look for another different method
                continue; // Look for other parse methods
            }
        }
    }

    // No more accessible parse method could be found.
    if(foundAtLeastOne) return false;
    else throw new RuntimeException(new NoSuchMethodException());
}


/**
 * METHOD: willParse<p><p>
 * 
 * A convienence method which calls the isParseable method, but does not throw any exceptions
 * which could be thrown through programatic errors.<p>
 * 
 * Use of {@link #isParseable(Object, String) isParseable} is recommended for use so programatic
 * errors can be caught in development, unless the value of the <code>parser</code> parameter is
 * unpredictable, or normal programtic exceptions should be ignored.<p>
 * 
 * See {@link #isParseable(Object, String) isParseable} for full description of method
 * usability.<p>
 * 
 * @param parser    The Class type or instantiated Object to find a parse method in.
 * @param str   The String you want to parse
 * 
 * @return true if a parse method was found and completed without exception
 * @see #isParseable(Object, String) for full description of method usability 
 */
public static boolean willParse(Object parser, String str) {
    try {
        return isParsable(parser, str);
    } catch(Throwable exception) {
        return false;
    }
}
0
7

To match only positive base-ten integers, that contains only ASCII digits, use:

public static boolean isNumeric(String maybeNumeric) {
    return maybeNumeric != null && maybeNumeric.matches("[0-9]+");
}
7

A well-performing approach avoiding try-catch and handling negative numbers and scientific notation.

Pattern PATTERN = Pattern.compile( "^(-?0|-?[1-9]\\d*)(\\.\\d+)?(E\\d+)?$" );

public static boolean isNumeric( String value ) 
{
    return value != null && PATTERN.matcher( value ).matches();
}
6

Here is my class for checking if a string is numeric. It also fixes numerical strings:

Features:

  1. Removes unnecessary zeros ["12.0000000" -> "12"]
  2. Removes unnecessary zeros ["12.0580000" -> "12.058"]
  3. Removes non numerical characters ["12.00sdfsdf00" -> "12"]
  4. Handles negative string values ["-12,020000" -> "-12.02"]
  5. Removes multiple dots ["-12.0.20.000" -> "-12.02"]
  6. No extra libraries, just standard Java

Here you go...

public class NumUtils {
    /**
     * Transforms a string to an integer. If no numerical chars returns a String "0".
     *
     * @param str
     * @return retStr
     */
    static String makeToInteger(String str) {
        String s = str;
        double d;
        d = Double.parseDouble(makeToDouble(s));
        int i = (int) (d + 0.5D);
        String retStr = String.valueOf(i);
        System.out.printf(retStr + "   ");
        return retStr;
    }

    /**
     * Transforms a string to an double. If no numerical chars returns a String "0".
     *
     * @param str
     * @return retStr
     */
    static String makeToDouble(String str) {

        Boolean dotWasFound = false;
        String orgStr = str;
        String retStr;
        int firstDotPos = 0;
        Boolean negative = false;

        //check if str is null
        if(str.length()==0){
            str="0";
        }

        //check if first sign is "-"
        if (str.charAt(0) == '-') {
            negative = true;
        }

        //check if str containg any number or else set the string to '0'
        if (!str.matches(".*\\d+.*")) {
            str = "0";
        }

        //Replace ',' with '.'  (for some european users who use the ',' as decimal separator)
        str = str.replaceAll(",", ".");
        str = str.replaceAll("[^\\d.]", "");

        //Removes the any second dots
        for (int i_char = 0; i_char < str.length(); i_char++) {
            if (str.charAt(i_char) == '.') {
                dotWasFound = true;
                firstDotPos = i_char;
                break;
            }
        }
        if (dotWasFound) {
            String befDot = str.substring(0, firstDotPos + 1);
            String aftDot = str.substring(firstDotPos + 1, str.length());
            aftDot = aftDot.replaceAll("\\.", "");
            str = befDot + aftDot;
        }

        //Removes zeros from the begining
        double uglyMethod = Double.parseDouble(str);
        str = String.valueOf(uglyMethod);

        //Removes the .0
        str = str.replaceAll("([0-9])\\.0+([^0-9]|$)", "$1$2");

        retStr = str;

        if (negative) {
            retStr = "-"+retStr;
        }

        return retStr;

    }

    static boolean isNumeric(String str) {
        try {
            double d = Double.parseDouble(str);
        } catch (NumberFormatException nfe) {
            return false;
        }
        return true;
    }

}
6

Regex Matching

Here is another example upgraded "CraigTP" regex matching with more validations.

public static boolean isNumeric(String str)
{
    return str.matches("^(?:(?:\\-{1})?\\d+(?:\\.{1}\\d+)?)$");
}
  1. Only one negative sign - allowed and must be in beginning.
  2. After negative sign there must be digit.
  3. Only one decimal sign . allowed.
  4. After decimal sign there must be digit.

Regex Test

1                  --                   **VALID**
1.                 --                   INVALID
1..                --                   INVALID
1.1                --                   **VALID**
1.1.1              --                   INVALID

-1                 --                   **VALID**
--1                --                   INVALID
-1.                --                   INVALID
-1.1               --                   **VALID**
-1.1.1             --                   INVALID
5

Exceptions are expensive, but in this case the RegEx takes much longer. The code below shows a simple test of two functions -- one using exceptions and one using regex. On my machine the RegEx version is 10 times slower than the exception.

import java.util.Date;


public class IsNumeric {

public static boolean isNumericOne(String s) {
    return s.matches("-?\\d+(\\.\\d+)?");  //match a number with optional '-' and decimal.      
}

public static boolean isNumericTwo(String s) {
    try {
        Double.parseDouble(s);
        return true;
    } catch (Exception e) {
        return false;
    }
}

public static void main(String [] args) {

    String test = "12345.F";

    long before = new Date().getTime();     
    for(int x=0;x<1000000;++x) {
        //isNumericTwo(test);
        isNumericOne(test);
    }
    long after = new Date().getTime();

    System.out.println(after-before);

}

}
4
  • Generally, I think this sort of code would be used to check things like typed input. In that case speed is not a consideration and doing something as ugly as throwing an exception to check for number or non-number is wrong.
    – user872985
    Aug 7, 2015 at 15:03
  • Maybe not. Typed input is generally checked by the UI component where errors can be immediately shown before submitting the value. It might be more common to be validating strings from large input text files -- where performance matters. The goal in my answer here is to address the "exceptions are slow" statement in the accepted answer. Complex regex is much more expensive. And there is no "ugly throw" in my code at all -- just a faster way to detect violations. With a check-first-then-calculate approach you make two passes through the input: one to verify and then another to convert. Aug 8, 2015 at 15:52
  • "On my machine the RegEx version is 10 times slower than the exception." - that's only because you test value that is numeric, so exception in never thrown. Test this on not numeric value, and version with exception will be slower than regex one. Feb 11, 2022 at 22:37
  • Excellent point. I thought that adding an "F" on the end would make it not numeric, but the java "parseDouble" likes it. I stand corrected. Feb 16, 2022 at 21:41
5

// please check below code

public static boolean isDigitsOnly(CharSequence str) {
    final int len = str.length();
    for (int i = 0; i < len; i++) {
        if (!Character.isDigit(str.charAt(i))) {
            return false;
        }
    }
    return true;
}
1
  • The question says "numeric" which could include non-integer values.
    – rghome
    Sep 16, 2016 at 13:18
4

You can use the java.util.Scanner object.

public static boolean isNumeric(String inputData) {
      Scanner sc = new Scanner(inputData);
      return sc.hasNextInt();
    }
3
// only int
public static boolean isNumber(int num) 
{
    return (num >= 48 && c <= 57); // 0 - 9
}

// is type of number including . - e E 
public static boolean isNumber(String s) 
{
    boolean isNumber = true;
    for(int i = 0; i < s.length() && isNumber; i++) 
    {
        char c = s.charAt(i);
        isNumber = isNumber & (
            (c >= '0' && c <= '9') || (c == '.') || (c == 'e') || (c == 'E') || (c == '')
        );
    }
    return isInteger;
}

// is type of number 
public static boolean isInteger(String s) 
{
    boolean isInteger = true;
    for(int i = 0; i < s.length() && isInteger; i++) 
    {
        char c = s.charAt(i);
        isInteger = isInteger & ((c >= '0' && c <= '9'));
    }
    return isInteger;
}

public static boolean isNumeric(String s) 
{
    try
    {
        Double.parseDouble(s);
        return true;
    }
    catch (Exception e) 
    {
        return false;
    }
}
3

This a simple example for this check:

public static boolean isNumericString(String input) {
    boolean result = false;

    if(input != null && input.length() > 0) {
        char[] charArray = input.toCharArray();

        for(char c : charArray) {
            if(c >= '0' && c <= '9') {
                // it is a digit
                result = true;
            } else {
                result = false;
                break;
            }
        }
    }

    return result;
}
3

I have illustrated some conditions to check numbers and decimals without using any API,

Check Fix Length 1 digit number

Character.isDigit(char)

Check Fix Length number (Assume length is 6)

String number = "132452";
if(number.matches("([0-9]{6})"))
System.out.println("6 digits number identified");

Check Varying Length number between (Assume 4 to 6 length)

//  {n,m}  n <= length <= m
String number = "132452";
if(number.matches("([0-9]{4,6})"))
System.out.println("Number Identified between 4 to 6 length");

String number = "132";
if(!number.matches("([0-9]{4,6})"))
System.out.println("Number not in length range or different format");

Check Varying Length decimal number between (Assume 4 to 7 length)

//  It will not count the '.' (Period) in length
String decimal = "132.45";
if(decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Numbers Identified between 4 to 7");

String decimal = "1.12";
if(decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Numbers Identified between 4 to 7");

String decimal = "1234";
if(decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Numbers Identified between 4 to 7");

String decimal = "-10.123";
if(decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Numbers Identified between 4 to 7");

String decimal = "123..4";
if(!decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Decimal not in range or different format");

String decimal = "132";
if(!decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Decimal not in range or different format");

String decimal = "1.1";
if(!decimal.matches("(-?[0-9]+(\.)?[0-9]*){4,6}"))
System.out.println("Decimal not in range or different format");

Hope it will help manyone.

3

Based off of other answers I wrote my own and it doesn't use patterns or parsing with exception checking.

It checks for a maximum of one minus sign and checks for a maximum of one decimal point.

Here are some examples and their results:

"1", "-1", "-1.5" and "-1.556" return true

"1..5", "1A.5", "1.5D", "-" and "--1" return false

Note: If needed you can modify this to accept a Locale parameter and pass that into the DecimalFormatSymbols.getInstance() calls to use a specific Locale instead of the current one.

 public static boolean isNumeric(final String input) {
    //Check for null or blank string
    if(input == null || input.isBlank()) return false;

    //Retrieve the minus sign and decimal separator characters from the current Locale
    final var localeMinusSign = DecimalFormatSymbols.getInstance().getMinusSign();
    final var localeDecimalSeparator = DecimalFormatSymbols.getInstance().getDecimalSeparator();

    //Check if first character is a minus sign
    final var isNegative = input.charAt(0) == localeMinusSign;
    //Check if string is not just a minus sign
    if (isNegative && input.length() == 1) return false;

    var isDecimalSeparatorFound = false;

    //If the string has a minus sign ignore the first character
    final var startCharIndex = isNegative ? 1 : 0;

    //Check if each character is a number or a decimal separator
    //and make sure string only has a maximum of one decimal separator
    for (var i = startCharIndex; i < input.length(); i++) {
        if(!Character.isDigit(input.charAt(i))) {
            if(input.charAt(i) == localeDecimalSeparator && !isDecimalSeparatorFound) {
                isDecimalSeparatorFound = true;
            } else return false;
        }
    }
    return true;
}
3

For non-negative number use this

public boolean isNonNegativeNumber(String str) {
  return str.matches("\\d+");
}

For any number use this

public boolean isNumber(String str) {
  return str.matches("-?\\d+");
}
2

I modified CraigTP's solution to accept scientific notation and both dot and comma as decimal separators as well

^-?\d+([,\.]\d+)?([eE]-?\d+)?$

example

var re = new RegExp("^-?\d+([,\.]\d+)?([eE]-?\d+)?$");
re.test("-6546"); // true
re.test("-6546355e-4456"); // true
re.test("-6546.355e-4456"); // true, though debatable
re.test("-6546.35.5e-4456"); // false
re.test("-6546.35.5e-4456.6"); // false
2

That's why I like the Try* approach in .NET. In addition to the traditional Parse method that's like the Java one, you also have a TryParse method. I'm not good in Java syntax (out parameters?), so please treat the following as some kind of pseudo-code. It should make the concept clear though.

boolean parseInteger(String s, out int number)
{
    try {
        number = Integer.parseInt(myString);
        return true;
    } catch(NumberFormatException e) {
        return false;
    }
}

Usage:

int num;
if (parseInteger("23", out num)) {
    // Do something with num.
}
4
  • yep, there's no "out parameters" in Java and since the Integer wrapper is immutable (thus cannot be used as a valid reference to store the output), the sensible idiomatic option would be to return an Integer object that could be null if the parse failed. An uglier option could be to pass an int[1] as output parameter.
    – fortran
    Jul 9, 2009 at 10:37
  • Yes, I remember a discussion about why Java has no output parameters. but returning an Integer (as null, if needed) would be fine too, I guess, though I don't know about Java's performance with regard to boxing/unboxing. Jul 9, 2009 at 11:19
  • 4
    I like C# as much as the next guy, but its no use adding a .NET C# code snippet for a Java question when the features don't exist in Java
    – Shane
    Jan 28, 2015 at 10:15
  • It would create a sonar issue if you don't log the exception
    – jmhostalet
    Apr 12, 2018 at 9:54
2

Parse it (i.e. with Integer#parseInt ) and simply catch the exception. =)

To clarify: The parseInt function checks if it can parse the number in any case (obviously) and if you want to parse it anyway, you are not going to take any performance hit by actually doing the parsing.

If you would not want to parse it (or parse it very, very rarely) you might wish to do it differently of course.

3
  • 2
    Costly if used extensibly Feb 3, 2014 at 18:18
  • It would create a sonar issue if you don't log the exception
    – jmhostalet
    Apr 12, 2018 at 9:54
  • Double.parseDouble
    – Alex78191
    Dec 4, 2018 at 15:01
2

You can use NumberUtils.isCreatable() from Apache Commons Lang.

Since NumberUtils.isNumber will be deprecated in 4.0, so use NumberUtils.isCreatable() instead.

2

Java 8 Stream, lambda expression, functional interface

All cases handled (string null, string empty etc)

String someString = null; // something="", something="123abc", something="123123"

boolean isNumeric = Stream.of(someString)
            .filter(s -> s != null && !s.isEmpty())
            .filter(Pattern.compile("\\D").asPredicate().negate())
            .mapToLong(Long::valueOf)
            .boxed()
            .findAny()
            .isPresent();

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