Java - Long valueOf(String s) method

---

---

Description

The Java Long valueOf(String s) method returns an Long object holding the value of the specified String s.

Declaration

Following is the declaration for java.lang.Long.valueOf() method

public static Long valueOf(String s) throws NumberFormatException

Parameters

s − This is the string to be parsed.

Return Value

This method returns an Long object holding the value represented by the string argument.

Exception

NumberFormatException − if the string cannot be parsed as an integer.

Example 1

The following example shows the usage of Long valueOf(String s) method to get the Long object using the specified String having an long value. We've created a String variable and assigned it a positive long value. Then using valueOf() method, we're getting the object and printing it.

package com.tutorialspoint;
public class LongDemo {
   public static void main(String[] args) {
      String s = "170";
      System.out.println("String = " + s);
    
      /* returns the Long object of the given string */
      System.out.println("valueOf = " + Long.valueOf(s));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

String = 170
valueOf = 170

Example 2

The following example shows the usage of Long valueOf(String s) method to get the Long object using the specified String having an long value. We've created a String variable and assigned it a negative long value. Then using valueOf() method, we're getting the object and printing it.

package com.tutorialspoint;
public class LongDemo {
   public static void main(String[] args) {
      String s = "-170";
      System.out.println("String = " + s);
    
      /* returns the Long object of the given string */
      System.out.println("valueOf = " + Long.valueOf(s));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

String = -170
valueOf = -170

Example 3

The following example shows the usage of Long valueOf(String s) method to get the Long object using the specified String having an long value. We've created a String variable and assigned it an invalid long value. Then using valueOf() method, we're trying to get the object and printing it. It will throw NumberFormatException.

package com.tutorialspoint;
public class LongDemo {
   public static void main(String[] args) {
      String s = "0x170";
      System.out.println("String = " + s);
    
      /* returns the Long object of the given string */
      System.out.println("valueOf = " + Long.valueOf(s));
   }
}

Output

Let us compile and run the above program, this will produce the following result −

String = 0x170
Exception in thread "main" java.lang.NumberFormatException: For input string: "0x170"
	at java.lang.NumberFormatException.forInputString(Unknown Source)
	at java.lang.Long.parseLong(Unknown Source)
	at java.lang.Long.valueOf(Unknown Source)
	at com.tutorialspoint.LongDemo.main(LongDemo.java:11)