Java.lang Package Classes

Java Long - parseLong() Method



The java.lang.Long.parseLong() method is used to parse the string argument as a signed long in the radix specified by the second argument. The characters in the string must all be digits of the specified radix (as determined by whether Character.digit(char, int) returns a nonnegative value), except that the first character may be an ASCII minus sign '-' ('\u002D') to indicate a negative value or an ASCII plus sign '+' ('\u002B') to indicate a positive value. The resulting long value is returned.

An exception of type NumberFormatException is thrown if any of the following situations occurs:

  • The first argument is null or is a string of length zero.
  • The radix is either smaller than Character.MIN_RADIX or larger than Character.MAX_RADIX.
  • Any character of the string is not a digit of the specified radix, except that the first character may be a minus sign '-' ('\u002d') or plus sign '+' ('\u002B') provided that the string is longer than length 1.
  • The value represented by the string is not a value of type long.

Syntax

public static long parseLong(String s,
                             int radix)
                      throws NumberFormatException

Parameters

s Specify the String containing the long representation to be parsed.
radix Specify the radix to be used while parsing s.

Return Value

Returns the long represented by the string argument in the specified radix.

Exception

Throws NumberFormatException, if the string does not contain a parsable long.

Example:

In the example below, the java.lang.Long.parseLong() method is used to parse the string argument as a signed long in the specified radix.

import java.lang.*;

public class MyClass {
  public static void main(String[] args) {
    
    //creating a string holding long value
    String x = "100";
    String y = "6F";

    //creating long value using radix as 2 (binary)
    long p = Long.parseLong(x, 2);

    //creating long value using radix as 16 (hexadecimal)
    long q = Long.parseLong(y, 16);

    //printing the string
    System.out.println("The string x is: " + x); 
    System.out.println("The string y is: " + y); 

    //printing the long values 
    System.out.println("The long value p is: " + p);   
    System.out.println("The long value q is: " + q);    
  }
}

The output of the above code will be:

The string x is: 100
The string y is: 6F
The long value p is: 4
The long value q is: 111

❮ Java.lang - Long

5