java.lang.Object
java.lang.Number
java.lang.Short
- すべての実装されたインタフェース:
Serializable
,Comparable<Short>
,Constable
public final class Short extends Number implements Comparable<Short>, Constable
Short
クラスは、プリミティブ型 short
の値をオブジェクトにラップします。 Short
型のオブジェクトには、型がshort
の単一フィールドが含まれます。
さらにこのクラスは、short
をString
に、String
をshort
に変換する各種メソッドや、short
の処理時に役立つ定数およびメソッドも提供します。
これはvalue-basedクラスです。プログラマは、equalのインスタンスを交換可能として扱い、同期にインスタンスを使用しないようにする必要があります。そうしないと、予期しない動作が発生する可能性があります。 たとえば、将来のリリースでは、同期が失敗する可能性があります。
-
フィールドのサマリー
フィールド -
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明byte
このShort
の縮小プリミティブ変換後の値をbyte
として返します。static int
compare
(short x, short y) 2つのshort
値を数値的に比較します。int
2つのShort
オブジェクトを数値的に比較します。static int
compareUnsigned
(short x, short y) 値を数値として扱う2つのshort
値を符号なしとして比較します。static Short
String
をShort
にデコードします。このインスタンスの名目記述子を含むOptional
を返します。double
このShort
の拡張プリミティブ変換後の値をdouble
として返します。boolean
このオブジェクトを指定されたオブジェクトと比較します。float
このShort
の拡張プリミティブ変換後の値をfloat
として返します。int
hashCode()
このShort
のハッシュ・コード(intValue()
を呼び出した場合の結果と等しくなる)を返します。static int
hashCode
(short value) Short.hashCode()
との互換性がある、short
値のハッシュ・コードを返します。int
intValue()
このShort
の拡張プリミティブ変換後の値をint
として返します。long
このShort
の拡張プリミティブ変換後の値をlong
として返します。static short
parseShort
(String s) 文字列の引数を符号付き10進数short
として構文解析します。static short
parseShort
(String s, int radix) 2番目の引数に指定された基数をもとにして、文字列の引数を符号付きshort
として構文解析します。static short
reverseBytes
(short i) 指定されたshort
値の2の補数バイナリ表現でバイトの順序を逆にして取得された値を返します。short
このShort
の値をshort
として返します。toString()
このShort
の値を表すString
オブジェクトを返します。static String
toString
(short s) 指定されたshort
を表す新しいString
オブジェクトを返します。static int
toUnsignedInt
(short x) 符号なし変換によって、その引数をint
に変換します。static long
toUnsignedLong
(short x) 符号なし変換によって、その引数をlong
に変換します。static Short
valueOf
(short s) 指定されたshort
値を表すShort
インスタンスを返します。static Short
特定のString
により指定された値を保持するShort
オブジェクトを返します。static Short
2番目の引数で指定された基数を使用した構文解析時に、指定されたString
から抽出された値を保持するShort
オブジェクトを返します。
-
フィールド詳細
-
MIN_VALUE
public static final short MIN_VALUEshort
に設定可能な最小値 -215を保持する定数。- 関連項目:
-
MAX_VALUE
public static final short MAX_VALUEshort
に設定可能な最大値215-1を保持する定数。- 関連項目:
-
TYPE
プリミティブ型short
を表すClass
インスタンス。 -
SIZE
public static final int SIZE2の補数バイナリ形式でshort
値を表すのに使用されるビット数。- 導入されたバージョン:
- 1.5
- 関連項目:
-
BYTES
public static final int BYTES2の補数バイナリ形式でshort
値を表すために使用されるバイト数。- 導入されたバージョン:
- 1.8
- 関連項目:
-
-
コンストラクタの詳細
-
Short
@Deprecated(since="9", forRemoval=true) public Short(short value) 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このコンストラクタを使用することはほとんどありません。 静的ファクトリvalueOf(short)
は、より良いスペースと時間のパフォーマンスをもたらす可能性が高いため、通常はより良い選択です。指定されたshort
値を表す、新しく割り当てられたShort
オブジェクトを構築します。- パラメータ:
value
-Short
によって表される値。
-
Short
@Deprecated(since="9", forRemoval=true) public Short(String s) throws NumberFormatException 削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。このコンストラクタを使用することはほとんどありません。 文字列をshort
プリミティブに変換するにはparseShort(String)
を使用し、文字列をShort
オブジェクトに変換するにはvalueOf(String)
を使用します。String
パラメータで示されるshort
値を表す、新しく割り当てられたShort
オブジェクトを構築します。 文字列は、基数10でparseShort
メソッドを使用するのと同じようにshort
値に変換されます。- パラメータ:
s
-Short
に変換するString
- 例外:
NumberFormatException
-String
が解析可能なshort
を含まない場合。
-
-
メソッドの詳細
-
toString
public static String toString(short s) 指定されたshort
を表す新しいString
オブジェクトを返します。 基数は10と見なされます。- パラメータ:
s
- 変換するshort
- 戻り値:
- 指定された
short
の文字列表現 - 関連項目:
-
parseShort
public static short parseShort(String s, int radix) throws NumberFormatException 2番目の引数に指定された基数をもとにして、文字列の引数を符号付きshort
として構文解析します。 文字列内の文字はすべて、指定された基数の桁である必要があります(Character.digit(char, int)
から負でない値が返されるかどうかで判定)。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果として得られるshort
値が返されます。以下に挙げる状況のどれかが発生した場合に、
NumberFormatException
型の例外がスローされます。- 1番目の引数が
null
であるか、長さゼロの文字列である。 - radixが
Character.MIN_RADIX
よりも小さいか、Character.MAX_RADIX
よりも大きい。 - 文字列の中に、指定された基数による桁には使えない文字がある。ただし、文字列の長さが1よりも大きい場合は、1番目の文字がマイナス記号
'-'
('\u002D'
)またはプラス記号'+'
('\u002B'
)であってもかまわない。 - 文字列によって表される値が、
short
型の値ではない。
- パラメータ:
s
- 解析対象のshort
表現を含むString
radix
- 解析時に使用する基数s
- 戻り値:
- 指定された基数での、文字列引数で表される
short
値。 - 例外:
NumberFormatException
-String
が解析可能なshort
を含まない場合。
- 1番目の引数が
-
parseShort
public static short parseShort(String s) throws NumberFormatException 文字列の引数を符号付き10進数short
として構文解析します。 文字列内の文字はすべて、10進数の桁である必要があります。ただし先頭の文字だけは、負の値を示すASCIIマイナス記号'-'
('\u002D'
)、正の値を示すASCIIプラス記号'+'
('\u002B'
)のどちらであってもかまいません。 結果となるshort
値が返されます。これは、その引数と基数10がparseShort(java.lang.String, int)
メソッドに引数として渡された場合とまったく同じです。- パラメータ:
s
- 解析対象のshort
表現を含むString
- 戻り値:
- 10進数の引数で表される
short
値。 - 例外:
NumberFormatException
- 文字列が解析可能なshort
を含まない場合。
-
valueOf
public static Short valueOf(String s, int radix) throws NumberFormatException 2番目の引数で指定された基数を使用した構文解析時に、指定されたString
から抽出された値を保持するShort
オブジェクトを返します。 最初の引数は、2番目の引数で指定された基数内の符号付き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
オブジェクトを返します。 引数は、符号付きの10進数のshort
を表しているとして解釈されます。これは、その引数がparseShort(java.lang.String)
メソッドに渡された場合とまったく同じです。 結果は、文字列により指定されたshort
値を表すShort
オブジェクトになります。つまり、このメソッドが返す
Short
オブジェクトの値は、次の値に等しくなります。new Short(Short.parseShort(s))
- パラメータ:
s
- 解析される文字列- 戻り値:
- 文字列引数により表される値を保持する
Short
オブジェクト - 例外:
NumberFormatException
-String
が解析可能なshort
を含まない場合。
-
describeConstable
public Optional<DynamicConstantDesc<Short>> describeConstable()このインスタンスの名目記述子を含むOptional
を返します。- 定義:
- インタフェース
Constable
内のdescribeConstable
- 戻り値:
- 「ショート」インスタンスを説明する
Optional
- 導入されたバージョン:
- 15
-
valueOf
public static Short valueOf(short s) 指定されたshort
値を表すShort
インスタンスを返します。 新規Short
インスタンスが不要な場合、通常このメソッドがコンストラクタShort(short)
に優先して使用されます。その理由は、このメソッドが頻繁に要求される値をキャッシュするので、操作に必要な領域や時間がはるかに少なくて済む場合が多いためです。 このメソッドは、-128から127の範囲(両端含む)の値を常にキャッシュしますが、この範囲に含まれないその他の値をキャッシュすることもあります。- パラメータ:
s
- short値。- 戻り値:
s
を表すShort
インスタンス。- 導入されたバージョン:
- 1.5
-
decode
public static Short decode(String nm) throws NumberFormatException String
をShort
にデコードします。 次の文法の10進数、16進数、および8進数を指定できます。- DecodableString:
- Signopt DecimalNumeral
- Signopt
0x
HexDigits- Signopt
0X
HexDigits- Signopt
#
HexDigits- Signopt
0
OctalDigits - Signopt
- Sign:
-
+
オプションの符号と基数指示子のどちらかまたはその両方に続く文字シーケンス(「
0x
」、「0X
」、「#
」、または先頭のゼロ)は、指定された基数(10、16、または8)でShort.parseShort
メソッドを使う場合と同じように構文解析されます。 この文字シーケンスは正の数でなければならず、そうでない場合はNumberFormatException
がスローされます。 指定されたString
の最初の文字が負の符号である場合、生成された結果は否定されます。String
に空白文字を指定することはできません。- パラメータ:
nm
- デコードするString
。- 戻り値:
nm
により表されるshort
値を保持するShort
オブジェクト- 例外:
NumberFormatException
-String
が解析可能なshort
を含まない場合。- 関連項目:
-
byteValue
public byte byteValue()このShort
の縮小プリミティブ変換後の値をbyte
として返します。- オーバーライド:
byteValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
byte
型に変換した値。 - Java言語仕様を参照してください:
-
5.1.3 プリミティブ・コンバージョンの解説
-
shortValue
public short shortValue()このShort
の値をshort
として返します。- オーバーライド:
shortValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
short
型に変換した値。
-
intValue
public int intValue()このShort
の拡張プリミティブ変換後の値をint
として返します。- 定義:
intValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
int
型に変換した値。 - Java言語仕様を参照してください:
-
5.1.2 プリミティブ変換の強化
-
longValue
public long longValue()このShort
の拡張プリミティブ変換後の値をlong
として返します。- 定義:
longValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
long
型に変換した値。 - Java言語仕様を参照してください:
-
5.1.2 プリミティブ変換の強化
-
floatValue
public float floatValue()このShort
の拡張プリミティブ変換後の値をfloat
として返します。- 定義:
floatValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
float
型に変換した値。 - Java言語仕様を参照してください:
-
5.1.2 プリミティブ変換の強化
-
doubleValue
public double doubleValue()このShort
の拡張プリミティブ変換後の値をdouble
として返します。- 定義:
doubleValue
、クラス:Number
- 戻り値:
- このオブジェクトが表す数値を
double
型に変換した値。 - Java言語仕様を参照してください:
-
5.1.2 プリミティブ変換の強化
-
toString
public String toString()このShort
の値を表すString
オブジェクトを返します。 値は、符号付きの10進数表現に変換され、文字列として返されます。これは、short
値がtoString(short)
メソッドに引数として渡された場合とまったく同じです。 -
hashCode
public int hashCode()このShort
のハッシュ・コード(intValue()
を呼び出した場合の結果と等しくなる)を返します。 -
hashCode
public static int hashCode(short value) Short.hashCode()
との互換性がある、short
値のハッシュ・コードを返します。- パラメータ:
value
- ハッシュ対象の値- 戻り値:
Short
値のハッシュ・コード値。- 導入されたバージョン:
- 1.8
-
equals
public boolean equals(Object obj) このオブジェクトを指定されたオブジェクトと比較します。 結果がtrue
になるのは、引数がnull
ではなく、このオブジェクトと同じshort
値を含むShort
オブジェクトである場合だけです。 -
compareTo
public int compareTo(Short anotherShort) 2つのShort
オブジェクトを数値的に比較します。- 定義:
compareTo
、インタフェース:Comparable<Short>
- パラメータ:
anotherShort
- 比較対象のShort
。- 戻り値:
- この
Short
が引数Short
と等しい場合は値0
、このShort
が引数Short
より小さい数値の場合は0
より小さい値、このShort
が引数Short
より大きい数値の場合は0
より大きい値(符号付きの比較)。 - 導入されたバージョン:
- 1.2
-
compare
public static int compare(short x, short y) 2つのshort
値を数値的に比較します。 返される値は、次から返される値と同じになります。Short.valueOf(x).compareTo(Short.valueOf(y))
- パラメータ:
x
- 比較する最初のshort
y
- 比較する2番目のshort
- 戻り値:
x == y
の場合は値0
、x < y
の場合は0
より小さい値、x> y
の場合は0
より大きい値- 導入されたバージョン:
- 1.7
-
compareUnsigned
public static int compareUnsigned(short x, short y) 値を数値として扱う2つのshort
値を符号なしとして比較します。- パラメータ:
x
- 比較する最初のshort
y
- 比較する2番目のshort
- 戻り値:
x == y
の場合は値0
、符号なしの値としてx < y
の場合は0
より小さい値、符号なしの値としてx> y
の場合は0
より大きい値- 導入されたバージョン:
- 9
-
reverseBytes
public static short reverseBytes(short i) 指定されたshort
値の2の補数バイナリ表現でバイトの順序を逆にして取得された値を返します。- パラメータ:
i
- バイトが逆にされる値- 戻り値:
- 指定された
short
値でバイト順を逆にして(つまり入れ替えて)取得した値。 - 導入されたバージョン:
- 1.5
-
toUnsignedInt
public static int toUnsignedInt(short x) 符号なし変換によって、その引数をint
に変換します。int
への符号なし変換では、int
の上位16ビットがゼロになり、下位16ビットがshort
引数のビットに等しくなります。 その結果、ゼロおよび正のshort
値は、数値的に等しいint
値にマッピングされ、負のshort
値は、入力プラス216に等しいint
値にマッピングされます。- パラメータ:
x
- 符号なしint
に変換する値- 戻り値:
- 符号なし変換によって
int
に変換された引数 - 導入されたバージョン:
- 1.8
-
toUnsignedLong
public static long toUnsignedLong(short x) 符号なし変換によって、その引数をlong
に変換します。long
への符号なし変換では、long
の上位48ビットがゼロになり、下位16ビットがshort
引数のビットに等しくなります。 結果として、ゼロおよび正のshort
値は、数値的に等しいlong
値にマッピングされ、負のshort
値は、入力+216に等しいlong
値にマッピングされます。- パラメータ:
x
- 符号なしlong
に変換する値- 戻り値:
- 符号なし変換によって
long
に変換された引数 - 導入されたバージョン:
- 1.8
-