java.lang
類別 Short

java.lang.Object
  java.lang.Number
      java.lang.Short

所有已實作的介面：

Serializable, Comparable<Short>

public final class Short
extends Number
implements Comparable<Short>

Short 類別在物件中包裹基本型別 short 的值。一個 Short 型別的物件只包含一個 short 型別的欄位。

另外，該類別提供了多個方法，可以將 short 轉換為 String，將 String 轉換為 short，同時還提供了其他一些處理 short 時有用的常數和方法。

從以下版本開始：

JDK1.1

另請參見：

Number, 序列化表格

欄位摘要

static short	MAX_VALUE 保存 short 可取的最大值的常數，最大值為 215-1。
static short	MIN_VALUE 保存 short 可取的最小值的常數，最小值為 -215。
static int	SIZE 用來以二進制補碼形式表示 short 值的位數。
static Class<Short>	TYPE 表示基本型別 short 的 Class 實例。

建構子摘要

Short(short value)
建構一個新分派的 Short 物件，用來表示指定的 short 值。

Short(String s)
建構一個新分派的 Short 物件，用來表示 String 參數所指示的 short 值。

方法摘要

byte	byteValue() 以 byte 形式返回此 Short 的值。
int	compareTo(Short anotherShort) 比較兩個 Short 物件所表示的數值。
static Short	decode(String nm) 將 String 解碼為 Short。
double	doubleValue() 以 double 形式返回此 Short 的值。
boolean	equals(Object obj) 將此物件與指定物件比較。
float	floatValue() 以 float 形式返回此 Short 的值。
int	hashCode() 返回此 Short 的雜湊碼。
int	intValue() 以 int 形式返回此 Short 的值。
long	longValue() 以 Long 形式返回此 Short 的值。
static short	parseShort(String s) 將字元串參數解析為有符號的十進制 short。
static short	parseShort(String s, int radix) 將字元串參數解析為由第二個參數指定的進制中的有符號的 short。
static short	reverseBytes(short i) 返回通過反轉指定 short 值的二進制補碼表示形式中位元組的順序而獲得的值。
short	shortValue() 以 short 形式返回此 Short 的值。
String	toString() 返回表示此 Short 的值的 String 物件。
static String	toString(short s) 返回表示指定 short 的一個新 String 物件。
static Short	valueOf(short s) 返回表示指定 short 值的 Short 實例。
static Short	valueOf(String s) 返回一個保持指定 String 所給出的值的 Short 物件。
static Short	valueOf(String s, int radix) 返回一個 Short 物件，該物件保持從指定的 String 中提取的值，該值是在使用第二個參數給出的進制對指定字元串進行解析時提取的。

從類別 java.lang.Object 繼承的方法

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

欄位詳細資訊

MIN_VALUE

public static final short MIN_VALUE

保存 short 可取的最小值的常數，最小值為 -2¹⁵。

另請參見：

常數欄位值

MAX_VALUE

public static final short MAX_VALUE

保存 short 可取的最大值的常數，最大值為 2¹⁵-1。

另請參見：

常數欄位值

TYPE

public static final Class<Short> TYPE

表示基本型別 short 的 Class 實例。

SIZE

public static final int SIZE

用來以二進制補碼形式表示 short 值的位數。

從以下版本開始：

1.5

另請參見：

常數欄位值

建構子詳細資訊

Short

public Short(short value)

建構一個新分派的 Short 物件，用來表示指定的 short 值。

參數：

valueShort - 所表示的值。

Short

public Short(String s)
      throws NumberFormatException

建構一個新分派的 Short 物件，用來表示 String 參數所指示的 short 值。將字元串轉換為 short 值，轉換方式與進制為 10 的 parseShort 方法所用的方式完全相同。

參數：

s - 要轉換為 Short 的 String

拋出：

NumberFormatException - 如果 String 不包含可解析的 short。

另請參見：

parseShort(java.lang.String, int)

方法詳細資訊

toString

public static String toString(short s)

返回表示指定 short 的一個新 String 物件。假定用十進製表示。

參數：

s - 所要轉換的 short

返回：

表示指定 short 的字元串

另請參見：

Integer.toString(int)

parseShort

public static short parseShort(String s)
                        throws NumberFormatException

將字元串參數解析為有符號的十進制 short。該字元串中的字元必須都是十進制數字，除非第一個字元是表示負值的 ASCII 符號中的負號 '-' ('\u002D')。返回得到的 short 值，此值與用該參數和進制 10 作為參數的 parseShort(java.lang.String, int) 方法得到的值相同。

參數：

s - 套件含要解析的 short 表示形式的 String

返回：

參數（十進制）表示的 short 值。

拋出：

NumberFormatException - 如果該字元串不包含可解析的 short。

parseShort

public static short parseShort(String s,
                               int radix)
                        throws NumberFormatException

將字元串參數解析為由第二個參數指定的進制中的有符號的 short。該字元串中的字元必須都是指定進制（這取決於 Character.digit(char, int) 是否返回非負值）的數字，除非第一個字元是表示負值的 ASCII 符號中的負號 “-” ('\u002D')。返回得到的 byte 值。

如果出現以下情形之一，則拋出 NumberFormatException 型別的異常：

• 第一個參數是 null 或零長度的字元串。
• 進制小於 Character.MIN_RADIX 或大於 Character.MAX_RADIX。
• 除了在字元串長度超過 1 的情況下第一個字元可能是負號 “-” ('\u002D') 之外，字元串的任何字元都不是指定進制的數字。
• 字元串所表示的值不是 short 型別的值。

參數：

s - 套件含要解析的 short 表示形式的 String

radix - 將在解析 s 時使用的進制

返回：

由指定進制中的字元串參數表示的 short。

拋出：

NumberFormatException - 如果 String 不包含可解析的 short。

valueOf

public static Short valueOf(String s,
                            int radix)
                     throws NumberFormatException

返回一個 Short 物件，該物件保持從指定的 String 中提取的值，該值是在使用第二個參數給出的進制對指定字元串進行解析時提取的。第一個參數被解釋為表示在使用第二個參數所指定進制時的一個有符號的 short，此值與用該參數作為參數的 parseShort(java.lang.String, int) 方法得到的值相同。結果是一個表示該字元串所指定的 short 值的 Short 物件。

換句話說，此方法返回一個 Short 物件，它的值等於：

new Short(Short.parseShort(s, radix))

參數：

s - 要解析的字元串

radix - 將在解釋 s 時使用的進制

返回：

保持指定進制中的字元串參數所表示的值的 Short 物件。

拋出：

NumberFormatException - 如果 String 不包含可解析的 short。

valueOf

public static Short valueOf(String s)
                     throws NumberFormatException

返回一個保持指定 String 所給出的值的 Short 物件。該參數被解釋為表示一個有符號的十進制 short，此值與用該參數作為參數的 #parseLong(java.lang.String) 方法得到的值相同。結果是一個表示該字元串所指定的 short 值的 Short 物件。

換句話說，此方法返回一個 Short 物件，它的值等於：

new Short(Short.parseShort(s))

參數：

s - 要解析的字元串

返回：

保持字元串參數所表示的值的 Short 物件

拋出：

NumberFormatException - 如果 String 不包含可解析的 short。

valueOf

public static Short valueOf(short s)

返回表示指定 short 值的 Short 實例。如果不需要新的 Short 實例，則通常應該優先採用此方法，而不是建構子 Short(short)，因為此方法很可能通過快取記憶體經常請求的值來顯著提高空間和時間性能。

參數：

s - 一個 short 值。

返回：

表示 s 的 Short 實例。

從以下版本開始：

1.5

decode

public static Short decode(String nm)
                    throws NumberFormatException

將 String 解碼為 Short。接受通過以下語法給出的十進制、十六進制和八進制數：

DecodableString:

Sign_opt DecimalNumeral

Sign_opt 0x HexDigits

Sign_opt 0X HexDigits

Sign_opt # HexDigits

Sign_opt 0 OctalDigits

Sign:

-

DecimalNumeral、HexDigits 和 OctalDigits 在 Java Language Specification 的 §3.10.1 中已經定義。

對（可選）負號和/或進制說明符（“0x”、“0X”、“#” 或前導零）後面的字元序列進行解析就如同用 Short.parseByte 方法來解析指定的進制（10、16 或 8）一樣。該字元序列必須表示為一個正值，否則將拋出 NumberFormatException。如果指定 String 的第一個字元是減號，則結果無效。String 中不允許出現空白字元。

參數：

nm - 要解碼的 String。

返回：

保持 nm 所表示的 short 值的 Short 物件

拋出：

NumberFormatException - 如果 String 不包含可解析的 short。

另請參見：

parseShort(java.lang.String, int)

byteValue

public byte byteValue()

以 byte 形式返回此 Short 的值。

覆寫：

類別 Number 中的 byteValue

返回：

轉換為 byte 型別後該物件表示的數值。

shortValue

public short shortValue()

以 short 形式返回此 Short 的值。

覆寫：

類別 Number 中的 shortValue

返回：

轉換為 short 型別後該物件表示的數值。

intValue

public int intValue()

以 int 形式返回此 Short 的值。

指定者：

類別 Number 中的 intValue

返回：

轉換為 int 型別後該物件表示的數值。

longValue

public long longValue()

以 Long 形式返回此 Short 的值。

指定者：

類別 Number 中的 longValue

返回：

轉換為 long 型別後該物件表示的數值。

floatValue

public float floatValue()

以 float 形式返回此 Short 的值。

指定者：

類別 Number 中的 floatValue

返回：

轉換為 float 型別後該物件表示的數值。

doubleValue

public double doubleValue()

以 double 形式返回此 Short 的值。

指定者：

類別 Number 中的 doubleValue

返回：

轉換為 double 型別後該物件表示的數值。

toString

public String toString()

返回表示此 Short 的值的 String 物件。該值被轉換成有符號的十進製表示形式，並作為一個字元串返回，正如將 short 值作為一個參數指定給 toString(short) 方法所得到的值那樣。

覆寫：

類別 Object 中的 toString

返回：

該物件值（十進制）的字元串表示形式。

hashCode

public int hashCode()

返回此 Short 的雜湊碼。

覆寫：

類別 Object 中的 hashCode

返回：

此物件的一個雜湊碼值。

另請參見：

Object.equals(java.lang.Object), Hashtable

equals

public boolean equals(Object obj)

將此物件與指定物件比較。當且僅當參數不是 null，而是一個與該物件一樣包含相同 short 值的 Short 物件時，結果才為 true。

覆寫：

類別 Object 中的 equals

參數：

obj - 將與之進行比較的物件。

返回：

如果這些物件相同，則返回 true；否則返回 false。

另請參見：

Object.hashCode(), Hashtable

compareTo

public int compareTo(Short anotherShort)

比較兩個 Short 物件所表示的數值。

指定者：

介面 Comparable<Short> 中的 compareTo

參數：

anotherShort - 要比較的 Short。

返回：

如果該 Short 等於參數 Short，則返回 0；如果該 Short 數值小於參數 Short，則返回小於 0 的值；如果該 Short 數值大於參數 Short，則返回大於 0 的值（有符號比較）。

從以下版本開始：

1.2

reverseBytes

public static short reverseBytes(short i)

返回通過反轉指定 short 值的二進制補碼表示形式中位元組的順序而獲得的值。

返回：

返回通過反轉（或者交換，效果相同）指定 short 值中的位元組而獲得的值。

從以下版本開始：

1.5