java.lang.Short decode(String nm)
Description
The decode(String nm) method of Short class decodes a String into a Short. Accepts decimal, hexadecimal, and octal numbers given by the following grammar:
DecodableString:
Signopt DecimalNumeral
Signopt 0x HexDigits
Signopt 0X HexDigits
Signopt # HexDigits
Signopt 0 OctalDigits
Sign:
–
+
DecimalNumeral, HexDigits, and OctalDigits are as defined in section 3.10.1 of The Java™ Language Specification, except that underscores are not accepted between digits.
The sequence of characters following an optional sign and/or radix specifier (“0x”, “0X”, “#”, or leading zero) is parsed as by the Short.parseShort method with the indicated radix (10, 16, or 8). This sequence of characters must represent a positive value or a NumberFormatException will be thrown. The result is negated if first character of the specified String is the minus sign. No whitespace characters are permitted in the String.
Important Notes:
- This method throws NumberFormatException, if the String does not contain a parsable short.
- the decode(String nm) method of Short class is static thus it should be accessed statically which means the we would be calling this method in this format:
Short.decode(String nm)Non static method is usually called by just declaring method_name(argument) however in this case since the method is static, it should be called by appending the class name as suffix. We will be encountering a compilation problem if we call the java decode method non statically
Method Syntax
public static Short decode(String nm) throws NumberFormatException
Method Argument
| Data Type | Parameter | Description |
|---|---|---|
| String | nm | the String to decode. |
Method Returns
The decode(String nm) method of Short class returns a Short object holding the short value represented by nm
Compatibility
Requires Java 1.0 and up
Java Short decode(String nm) Example
Below is a simple java example on the usage of decode(String nm) method of Short class.
package com.javatutorialhq.java.examples;
import java.util.Scanner;
/*
* This example source code demonstrates the use of
* decode(String nm) method of Short class
*/
public class ShortDecodeExample {
public static void main(String[] args) {
// Ask for user input
System.out.print("Enter a value:");
// declare a scanner object to read the user input
Scanner s = new Scanner(System.in);
// assign the input to a variable
String value = s.nextLine();
// get the decode() method result
Short result = Short.decode(value);
// print the result
System.out.println("Result:" + result);
// close the scanner object
s.close();
/*
* Format available
* 0x HexDigits
* 0X HexDigits
* # HexDigits
* 0 OctalDigits
*/
}
}
The above example will ask for user input and will decode it to short value. Make sure to follow the format allowed as mentioned in the description.
