Float (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

java.lang
클래스 Float

java.lang.Object 
  java.lang.Number 
      java.lang.Float

모든 구현된 인터페이스:: Serializable , Comparable <Float >

public final class Float
extends Number
implements Comparable <Float >
extends Number
implements Comparable <Float >

Float 클래스는, 원시형 float 의 값을 객체내에 랩 합니다. Float 형의 객체에는,float 형의 단일의 필드가 있습니다.

한층 더 이 클래스는,float 를 String 에,String 를 float 로 변환하는 각종 메소드나,float 의 처리시에 도움이 되는 정수 및 메소드도 제공합니다.

도입된 버젼:: JDK1. 0
관련 항목:: 직렬화 된 형식

필드의 개요
`static int`	`MAX_EXPONENT` 유한의 `float` 변수가 가질 가능성이 있는 최대 지수입니다.
`static float`	`MAX_VALUE` `float` 형의 정의 최대 유한치 (2-2^-23) ·2¹²⁷ 입니다.
`static int`	`MIN_EXPONENT` 표준화 된 `float` 변수가 가질 가능성이 있는 최소 지수입니다.
`static float`	`MIN_NORMAL` `float` 형의 정의 최소 일반적으로치 2^-126 입니다.
`static float`	`MIN_VALUE` `float` 형의 정의 최소 유한치 2^-149 입니다.
`static float`	`NaN` `float` 형의 비수 (NaN) 치를 보관 유지하는 정수입니다.
`static float`	`NEGATIVE_INFINITY` `float` 형의 부의 무한대를 보관 유지하는 정수입니다.
`static float`	`POSITIVE_INFINITY` `float` 형의 정의 무한대를 보관 유지하는 정수입니다.
`static int`	`SIZE` `float` 치를 나타내는데 사용되는 비트수
`static Class <Float >`	`TYPE` `float` 의 원시형을 나타내는 `Class` 인스턴스

생성자 의 개요
`Float (double value)` `float` 형에 변환된 인수를 나타내는, 새롭게 할당할 수 있었던 `Float` 객체를 구축합니다.
`Float (float value)` 프리미티브(primitive)인 `float` 형의 인수를 나타내는, 새롭게 할당할 수 있었던 `Float` 객체를 구축합니다.
`Float (String s)` 캐릭터 라인으로 나타내지는 `float` 형의 부동 소수점치를 나타내는, 새롭게 할당할 수 있었던 `Float` 객체를 구축합니다.

메소드의 개요
`byte`	`byteValue ()` 이 `Float` 의 값을 (`byte` 에 캐스트 하는 것으로써) `byte` 로서 돌려줍니다.
`static int`	`compare (float f1, float f2)` 지정된 2 개의 `float` 치를 비교합니다.
`int`	`compareTo (Float anotherFloat)` 2 개의 `Float` 객체를 수치적으로 비교합니다.
`double`	`doubleValue ()` 이 `Float` 객체의 `double` 치를 돌려줍니다.
`boolean`	`equals (Object obj)` 객체와 지정된 객체를 비교합니다.
`static int`	`floatToIntBits (float value)` IEEE 754 부동 소수점의 「싱글 포맷 (double format)」비트 레이아웃에 따라, 지정된 부동 소수점의 값을 표현해 돌려줍니다.
`static int`	`floatToRawIntBits (float value)` IEEE 754 부동 소수점의 「싱글 포맷 (double format)」비트 레이아웃에 따라, 비수 (NaN) 치를 보관 유지하는, 지정된 부동 소수점치의 표현을 돌려줍니다.
`float`	`floatValue ()` 이 `Float` 객체의 `float` 치를 돌려줍니다.
`int`	`hashCode ()` 이 `Float` 객체의 해시 코드를 돌려줍니다.
`static float`	`intBitsToFloat (int bits)` 지정된 비트 표현과 대응하는 `float` 치를 돌려줍니다.
`int`	`intValue ()` 이 `Float` 의 값을 (`int` 형에 캐스트 하는 것으로써) `int` 로서 돌려줍니다.
`boolean`	`isInfinite ()` 이 `Float` 치의 절대치가 무한량인 경우에는 `true` 를, 그렇지 않은 경우에는 `false` 를 돌려줍니다.
`static boolean`	`isInfinite (float v)` 지정된 수치의 절대치가 무한량인 경우에는 `true` 를, 그렇지 않은 경우에는 `false` 를 돌려줍니다.
`boolean`	`isNaN ()` 이 `Float` 치가 비수 (NaN)인 경우에는 `true` 를, 그렇지 않은 경우는 `false` 를 돌려줍니다.
`static boolean`	`isNaN (float v)` 지정된 수치가 비수 (NaN)인 경우에는 `true` 를, 그렇지 않은 경우는 `false` 를 돌려줍니다.
`long`	`longValue ()` 이 `Float` 의 값을 (`long` 형에 캐스트 하는 것으로써) `long` 로서 돌려줍니다.
`static float`	`parseFloat (String s)` `Float` 클래스의 `valueOf` 메소드를 실행했을 경우와 같게, 지정된 `String` 가 나타내는 값에 초기화된 새로운 `float` 치를 돌려줍니다.
`short`	`shortValue ()` 이 `Float` 의 값을 (`short` 에 캐스트 하는 것으로써) `short` 로서 돌려줍니다.
`static String`	`toHexString (float f)` `float` 인수의 16 진수 캐릭터 라인 표현을 돌려줍니다.
`String`	`toString ()` 이 `Float` 객체의 캐릭터 라인 표현을 돌려줍니다.
`static String`	`toString (float f)` `float` 인수의 캐릭터 라인 표현을 돌려줍니다.
`static Float`	`valueOf (float f)` 지정한 `float` 치를 나타내는 `Float` 인스턴스를 돌려줍니다.
`static Float`	`valueOf (String s)` 캐릭터 라인 인수 `s` 로 나타내지는 `float` 치를 보관 유지하는 `Float` 객체를 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드
`clone , finalize , getClass , notify , notifyAll , wait , wait , wait`

필드의 상세

POSITIVE_INFINITY

public static final float POSITIVE_INFINITY

float 형의 정의 무한대를 보관 유지하는 정수입니다. Float.intBitsToFloat(0x7f800000) 가 돌려주는 값과 같습니다.

관련 항목:: 정수 필드치

NEGATIVE_INFINITY

public static final float NEGATIVE_INFINITY

float 형의 부의 무한대를 보관 유지하는 정수입니다. Float.intBitsToFloat(0xff800000) 가 돌려주는 값과 같습니다.

관련 항목:: 정수 필드치

NaN

public static final float NaN

float 형의 비수 (NaN) 치를 보관 유지하는 정수입니다. Float.intBitsToFloat(0x7fc00000) 가 돌려주는 값과 같습니다.

관련 항목:: 정수 필드치

MAX_VALUE

public static final float MAX_VALUE

float 형의 정의 최대 유한치 (2-2^-23) ·2¹²⁷ 입니다. 16 진수 부동 소수점 리터럴 0x1.fffffeP+127f 로 동등하고,Float.intBitsToFloat(0x7f7fffff) 와도 동등합니다.

관련 항목:: 정수 필드치

MIN_NORMAL

public static final float MIN_NORMAL

float 형의 정의 최소 일반적으로치 2^-126 입니다. 16 진수 부동 소수점 리터럴 0x1. 0p-126f 로 동등하고,Float.intBitsToFloat(0x00800000) 와도 동등합니다.

도입된 버젼:: 1.6
관련 항목:: 정수 필드치

MIN_VALUE

public static final float MIN_VALUE

float 형의 정의 최소 유한치 2^-149 입니다. 16 진수 부동 소수점 리터럴 0x0. 000002P-126f 로 동등하고,Float.intBitsToFloat(0x1) 와도 동등합니다.

관련 항목:: 정수 필드치

MAX_EXPONENT

public static final int MAX_EXPONENT

유한의 float 변수가 가질 가능성이 있는 최대 지수입니다. Math.getExponent(Float.MAX_VALUE) 가 돌려주는 값과 같습니다.

도입된 버젼:: 1.6
관련 항목:: 정수 필드치

MIN_EXPONENT

public static final int MIN_EXPONENT

표준화 된 float 변수가 가질 가능성이 있는 최소 지수입니다. Math.getExponent(Float.MIN_NORMAL) 가 돌려주는 값과 같습니다.

도입된 버젼:: 1.6
관련 항목:: 정수 필드치

SIZE

public static final int SIZE

float 치를 나타내는데 사용되는 비트수

도입된 버젼:: 1.5
관련 항목:: 정수 필드치

TYPE

public static final Class <Float > TYPE

float 의 원시형을 나타내는 Class 인스턴스

도입된 버젼:: JDK1. 1

생성자 의 상세

Float

public Float(float value)

프리미티브(primitive)인 float 형의 인수를 나타내는, 새롭게 할당할 수 있었던 Float 객체를 구축합니다.

파라미터:: value - Float 에 의해 나타내지는 값

Float

public Float(double value)

float 형에 변환된 인수를 나타내는, 새롭게 할당할 수 있었던 Float 객체를 구축합니다.

파라미터:: value - Float 에 의해 나타내지는 값

Float

public Float(String  s)
      throws NumberFormatException

캐릭터 라인으로 나타내지는 float 형의 부동 소수점치를 나타내는, 새롭게 할당할 수 있었던 Float 객체를 구축합니다. 캐릭터 라인은,valueOf 메소드를 사용하는 경우와 같게 해 float 치에 변환됩니다.

파라미터:: s - Float 로 변환하는 캐릭터 라인
예외:: NumberFormatException - 캐릭터 라인이 구문 분석 가능한 수치를 포함하지 않는 경우
관련 항목:: valueOf(java.lang.String)

메소드의 상세

toString

public static String  toString(float f)

float 인수의 캐릭터 라인 표현을 돌려줍니다. 이하의 문자는 모두 ASCII 문자입니다.

인수가 NaN 의 경우, 변환 후의 캐릭터 라인은 「NaN」
그렇지 않은 경우, 결과는, 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호가 부의 경우, 변환 후의 캐릭터 라인의 최초의 문자는 「-」( 「\u002D」). 부호가 정의 경우, 변환 후의 캐릭터 라인에 부호 문자는 표시되지 않는다. 절대치 m 에 대해서는, 다음대로
- m 가 무한대의 경우는,"Infinity" 라고 하는 캐릭터 라인으로 나타낸다. 즉, 정의 무한대는 "Infinity", 부의 무한대는 "-Infinity" 가 된다
- m 가 제로의 경우는,"0.0" 이라고 하는 캐릭터 라인으로 나타낸다. 즉, 부의 제로는 "-0. 0", 정의 제로는 "0.0" 이 된다
- m 가 10^-3 이상으로 10⁷ 미만의 경우는,m 의 정수부로서 선두에 제로가 붙지 않는 10 진수, 소수점 '. ' ('\u002E'),m 의 소수부를 나타내는 1 자리수 이상의 10 진수가 이 순서로 나란해진 형태로 표현된다
- m 가 10^-3 미만, 혹은 10⁷ 이상의 경우는, 부동 소수점 표시 형식에서 표현한다. 예를 들어,n 가 10ⁿ<= m < 10ⁿ⁺¹ 에 해당하는 일의의 정수,a 가 1 <= a < 10 이 되는 것 같은,m 와 10ⁿ 의 수학적으로 정확한 상으로 한다. 이 경우, 절대치는 Integer.toString(int) 메소드로부터 돌려주어졌던 대로,a 의 정수부인 1 자리수의 10 진수, 「. 」( 「\u002E」),a 의 소수부를 나타내는 10 진수, 문자 「E」( 「\u0045」),n 를 나타내는 10 진정수가, 이 순서로 나란해진 형태로 표현된다

m 또는 a 의 소수부로서 출력하는 자리수를 검토해 봅시다. 소수부를 나타내는 자리수는 1 자리수 이상이 필요합니다. float 형의 인접하는 값으로부터 인수를 일의에 식별하는데 최저한 필요한 자리수로 해 주세요. 예를 들어, 제로가 아닌 유한의 인수 f 를 지정해 이 메소드로 작성한 10 진수 표기를 x 로 합니다. 이 경우,f 는 x 의 float 형의 최근 닮고 값이 아니면 안됩니다. 즉, 2 개의 float 치가 균등하게 x 에 근사 하고 있는 경우이면,f 는 2 개의 값의 어느 쪽인지 나오지 않으면 안되어, 유효한 최하정도 비트는 0 이 아니면 안됩니다.

부동 소수점치의 로컬라이즈 된 캐릭터 라인 표현을 작성하는 경우,NumberFormat 의 서브 클래스를 사용합니다.

파라미터:: f - 변환 대상의 float
반환값:: 이 인수의 캐릭터 라인 표현

toHexString

public static String  toHexString(float f)

float 인수의 16 진수 캐릭터 라인 표현을 돌려줍니다. 이하의 문자는 모두 ASCII 문자입니다.

인수가 NaN 의 경우, 변환 후의 캐릭터 라인은 「NaN」
그렇지 않은 경우, 결과는, 인수의 부호 및 절대치를 나타내는 캐릭터 라인이 됩니다. 부호가 부의 경우, 변환 후의 캐릭터 라인의 최초의 문자는 「-」( 「\u002D」). 부호가 정의 경우, 변환 후의 캐릭터 라인에 부호 문자는 표시되지 않는다. 절대치 m 에 대해서는, 다음대로
- m 가 무한대의 경우는, 「Infinity」라고 하는 캐릭터 라인으로 나타낸다. 즉, 정의 무한대는 「Infinity」, 부의 무한대는 「-Infinity」라고 된다
- m 가 제로의 경우는, 「0x0. 0p0」이라고 하는 캐릭터 라인으로 나타낸다. 즉, 부의 제로는 「-0x0. 0p0」, 정의 제로는 「0x0. 0p0」이라고 된다
- m 가 float 치의 경우는, 유효 숫자와 지수의 필드를 나타내는데 부분 캐릭터 라인이 사용된다. 유효 숫자는, 캐릭터 라인 「0x1. 」라고, 소수부로서 나머지의 유효 숫자의 소문자의 16 진표현을 계속해 나타내진다. 모든 자리수가 0 이 아닌 한 (모든 것이 0 의 경우는 단일의 0 을 사용) , 16 진표현의 말미의 0 은 삭제된다. 다음에, 지수는, 지수치로 Integer.toString 를 호출해 생성할 때와 같이, 「p」라고 거기에 계속되는 완전한 지수의 10 진수 캐릭터 라인으로 나타내진다.
- m 가 비정규 표현의 float 치의 경우는, 유효 숫자는, 캐릭터 라인 「0x0. 」라고, 소수부로서 나머지의 유효 숫자의 16 진표현을 계속해 나타내진다. 16 진표현의 말미의 0 은 삭제됩니다. 다음에, 지수는 「p-126」로 나타내진다. 서브 노멀 유효 숫자내에, 제로가 아닌 숫자가 1 개 이상 존재할 필요가 있는 것에 유의해 주세요.

례
부동 소수점치	16 진수 캐릭터 라인
`1.0`	`0x1. 0p0`
`-1. 0`	`-0x1. 0p0`
`2.0`	`0x1. 0p1`
`3.0`	`0x1. 8p1`
`0.5`	`0x1. 0p-1`
`0.25`	`0x1. 0p-2`
`Float.MAX_VALUE`	`Float.MAX_VALUE`
`0x1.fffffep127 Minimum Normal Value`	`0x1. 0p-126`
`Maximum Subnormal Value`	`0x0.fffffep-126`
`Float.MIN_VALUE`	`0x0. 000002p-126`

파라미터:: f - 변환 대상의 float 인수의 16 진수 캐릭터 라인 표현
반환값:: 이 인수의 16 진수의 캐릭터 라인 표현
도입된 버젼:: 1.5

valueOf

public static Float  valueOf(String  s)
                     throws NumberFormatException

캐릭터 라인 인수 s 로 나타내지는 float 치를 보관 유지하는 Float 객체를 돌려줍니다.

s 가 null 의 경우는,NullPointerException 가 throw 됩니다.

s 내의 선두와 말미의 공백 문자는 무시됩니다. 공백 문자는,String.trim() 메소드로 삭제될 때와 같이 삭제됩니다. 즉, ASCII 의 공백 문자와 제어 문자의 양쪽 모두가 삭제됩니다. s 의 나머지의 문자가, 다음의 자구 구문 규칙에 따라 FloatValue 를 구성합니다.

FloatValue:
Sign_opt NaN
Sign_opt Infinity
Sign_opt FloatingPointLiteral
Sign_opt HexFloatingPointLiteral
SignedInteger

HexFloatingPointLiteral:
HexSignificand BinaryExponent FloatTypeSuffix_opt

HexSignificand:
HexNumeral
HexNumeral .
0x HexDigits_opt. HexDigits
0X HexDigits_opt. HexDigits

BinaryExponent:
BinaryExponentIndicator SignedInteger

BinaryExponentIndicator:
p
P

여기서,Sign,FloatingPointLiteral,HexNumeral,HexDigits,SignedInteger, 및 FloatTypeSuffix 는 「Java 언어 스펙」의 자구 구조 섹션의 정의에 따릅니다. s 가 FloatValue 의 형식이 아닌 경우,NumberFormatException 가 throw 됩니다. 그렇지 않은 경우,s 는 일반적으로의 「부동 소수점 표기」, 즉 정확한 10 진수 또는 16 진수를 나타내고 있다고 보여집니다. 이 정확한 수치는, 개념상은 「무한하게 정확한 바이너리치」에 변환되고 나서, IEEE 754 부동 소수점 계산법에 따르는 일반적으로의 최근 닮고 값 둥근 법 (제로치의 부호 보관 유지를 포함한다)에 따라 float 형에 말 수 있습니다. 마지막으로,float 치를 나타내는 Float 객체가 돌려주어집니다.

부동 소수점치의 로컬라이즈 된 캐릭터 라인 표현을 해석하는 경우,NumberFormat 의 서브 클래스를 사용합니다.

부동 소수점 리터럴의 형태를 결정하는 지시자의 말미 형식 지시자 (1.0f 는 float 치,1.0d 는 double 치)는, 이 메소드의 결과에 영향을 주지 않습니다. 즉, 입력 캐릭터 라인의 수치는, 타겟의 부동 소수점형에 직접 변환됩니다. 일반적으로, 캐릭터 라인을 double 로 변환해,double 를 float 로 변환하는 2 단계의 순서는, 캐릭터 라인을 float 에 직접 변환하는 것과 등가가 아닙니다. 예를 들어, 중간의 double 로 변환해, 다음에 float 로 변환했을 경우, 캐릭터 라인
「1.00000017881393421514957253748434595763683319091796875001d」
의 결과는 float 치 1.0000002f 입니다만, 캐릭터 라인을 직접 float 로 변환했을 경우, 결과는 1.0000001f 입니다.

무효인 캐릭터 라인으로 이 메소드가 불려 가거나NumberFormatException 가 throw 되거나 하지 않게 하기 위해서,Double.valueOf 의 메뉴얼에는, 입력의 스크리닝에 사용할 수 있는 정규 표현이 기재되어 있습니다.

파라미터:: s - 구문 분석 되는 캐릭터 라인
반환값:: String 인수에 의해 나타내지는 값을 보관 유지하는 Float 객체
예외:: NumberFormatException - 캐릭터 라인이 구문 분석 가능한 수치를 포함하지 않는 경우

valueOf

public static Float  valueOf(float f)

지정한 float 치를 나타내는 Float 인스턴스를 돌려줍니다. 신규 Float 인스턴스가 불필요한 경우, 일반적으로 이 메소드가 생성자 Float(float) 에 우선해 사용됩니다. 그 이유는, 이 메소드가 빈번하게 요구되는 값을 캐쉬하므로, 조작에 필요한 영역이나 시간이 훨씬 적어도 되는 경우가 많기 때문입니다.

파라미터:: f - float 치
반환값:: f 를 나타내는 Float 인스턴스
도입된 버젼:: 1.5

parseFloat

public static float parseFloat(String  s)
                        throws NumberFormatException

Float 클래스의 valueOf 메소드를 실행했을 경우와 같게, 지정된 String 가 나타내는 값에 초기화된 새로운 float 치를 돌려줍니다.

파라미터:: s - 구문 분석 되는 캐릭터 라인
반환값:: 캐릭터 라인 인수로 나타내지는 float 치
예외:: NumberFormatException - 캐릭터 라인이 구문 분석 가능한 float 치를 포함하지 않는 경우
도입된 버젼:: 1.2
관련 항목:: valueOf(String)

isNaN

public static boolean isNaN(float v)

지정된 수치가 비수 (NaN)인 경우에는 true 를, 그렇지 않은 경우는 false 를 돌려줍니다.

파라미터:: v - 판정되는 값
반환값:: 인수가 NaN 인 경우는 true, 그렇지 않은 경우는 false

isInfinite

public static boolean isInfinite(float v)

지정된 수치의 절대치가 무한량인 경우에는 true 를, 그렇지 않은 경우에는 false 를 돌려줍니다.

파라미터:: v - 판정되는 값
반환값:: 인수가 정의 무한대 또는 부의 무한대인 경우는 true, 그렇지 않은 경우는 false

isNaN

public boolean isNaN()

이 Float 치가 비수 (NaN)인 경우에는 true 를, 그렇지 않은 경우는 false 를 돌려줍니다.

반환값:: 이 객체가 나타내는 값이 NaN 인 경우는 true, 그렇지 않은 경우는 false

isInfinite

public boolean isInfinite()

이 Float 치의 절대치가 무한량인 경우에는 true 를, 그렇지 않은 경우에는 false 를 돌려줍니다.

반환값:: 이 객체가 나타내는 값이 정의 무한대 또는 부의 무한대인 경우는 true, 그렇지 않은 경우는 false

toString

public String  toString()

이 Float 객체의 캐릭터 라인 표현을 돌려줍니다. 이 객체가 나타내는 프리미티브(primitive) float 치는, 1 개의 인수를 취하는 toString 메소드를 실행했을 경우와 같은 String 에 변환됩니다.

오버라이드(override):: 클래스 Object 내의 toString

반환값:: 이 객체의 String 표현
관련 항목:: toString(float)

byteValue

public byte byteValue()

이 Float 의 값을 (byte 에 캐스트 하는 것으로써) byte 로서 돌려줍니다.

오버라이드(override):: 클래스 Number 내의 byteValue

반환값:: byte 형에 변환된 이 객체가 나타내는 float 치

shortValue

public short shortValue()

이 Float 의 값을 (short 에 캐스트 하는 것으로써) short 로서 돌려줍니다.

오버라이드(override):: 클래스 Number 내의 shortValue

반환값:: short 형에 변환된 이 객체가 나타내는 float 치
도입된 버젼:: JDK1. 1

intValue

public int intValue()

이 Float 의 값을 (int 형에 캐스트 하는 것으로써) int 로서 돌려줍니다.

정의:: 클래스 Number 내의 intValue

반환값:: int 형에 변환된 이 객체가 나타내는 float 치

longValue

public long longValue()

이 Float 의 값을 (long 형에 캐스트 하는 것으로써) long 로서 돌려줍니다.

정의:: 클래스 Number 내의 longValue

반환값:: long 형에 변환된 이 객체가 나타내는 float 치

floatValue

public float floatValue()

이 Float 객체의 float 치를 돌려줍니다.

정의:: 클래스 Number 내의 floatValue

반환값:: 이 객체가 나타내는 float 치

doubleValue

public double doubleValue()

이 Float 객체의 double 치를 돌려줍니다.

정의:: 클래스 Number 내의 doubleValue

반환값:: 이 객체가 나타내는 float 치를 double 형으로 변환한 값

hashCode

public int hashCode()

이 Float 객체의 해시 코드를 돌려줍니다. 결과는,floatToIntBits(float) 메소드로 생성했을 경우와 완전히 똑같이, 이 Float 객체가 나타내는 프리미티브(primitive) float 치의 int 형 비트 표현이 됩니다.

오버라이드(override):: 클래스 Object 내의 hashCode

반환값:: 이 객체의 해시 코드값
관련 항목:: Object.equals(java.lang.Object) , Hashtable

equals

public boolean equals(Object  obj)

객체와 지정된 객체를 비교합니다. 결과가 true 가 되는 것은, 인수가 null 가 아니고, 이 객체가 나타내는 float 치와 같은 값을 보관 유지하는 float 를 나타내는 Float 객체인 경우만입니다. 이 때문에, 2 개의 float 치가 동일하다고 보여지는 것은,floatToIntBits(float) 메소드를 각 치에 적용했을 때에 동일한 int 치가 반환되는 경우만입니다.

대부분의 경우,Float 클래스의 2 개의 인스턴스 f1 및 f2 에 대해,f1.equals(f2) 의 값이 true 가 되는 것은, 다음의 식의 값이 true 가 되는 경우만입니다.

   f1.floatValue() == f2.floatValue()

그러나, 예외 사항도 2 개 있습니다.

f1 및 f2 의 양쪽 모두가 Float.NaN 를 나타내는 경우는,Float.NaN==Float.NaN 의 값이 false 여도,equals 메소드는 true 를 돌려준다
f1 가 +0. 0f 를 나타내,f2 가 -0. 0f 를 나타내는 경우, 혹은 f1 가 -0. 0f 를 나타내,f2 가 +0. 0f 를 나타내는 경우는,0.0f==-0. 0f 의 값이 true 여도,equal 메소드의 결과는 false 가 된다

이 정의에 의해, 해시 테이블은 올바르게 동작합니다.

오버라이드(override):: 클래스 Object 내의 equals

파라미터:: obj - 비교 대상의 객체
반환값:: 객체가 같은 경우는 true, 그렇지 않은 경우는 false
관련 항목:: floatToIntBits(float)

floatToIntBits

public static int floatToIntBits(float value)

IEEE 754 부동 소수점의 「싱글 포맷 (double format)」비트 레이아웃에 따라, 지정된 부동 소수점의 값을 표현해 돌려줍니다.

비트 31 (마스크 0x80000000 로 선택되는 비트)은, 부동 소수점수(실수)치의 부호를 나타내는 비트 30 ~ 23 (마스크 0x7f800000 로 선택되는 비트)은, 지수를 나타내는 비트 22 ~ 0 (마스크 0x007fffff 로 선택되는 비트)은, 부동 소수점수(실수)치의 유효 숫자 (가수)를 나타내는

인수가 정의 무한대의 경우는,0x7f800000 가 반환되는

인수가 부의 무한대의 경우는,0xff800000 가 반환되는

인수가 NaN 의 경우는,0x7fc00000 가 반환되는

어느 경우도, 반환되는 값은 정수이며,intBitsToFloat(int) 메소드를 지정하면(자),floatToIntBits 에의 인수와 같은 부동 소수점치가 됩니다 (모든 NaN 치가 단일의 「정규」NaN 치에 수납되는 것을 제외한다).

파라미터:: value - 부동 소수점치
반환값:: 부동 소수점치를 나타내는 비트

floatToRawIntBits

public static int floatToRawIntBits(float value)

IEEE 754 부동 소수점의 「싱글 포맷 (double format)」비트 레이아웃에 따라, 비수 (NaN) 치를 보관 유지하는, 지정된 부동 소수점치의 표현을 돌려줍니다.

인수가 정의 무한대의 경우는,0x7f800000 가 반환되는

인수가 부의 무한대의 경우는,0xff800000 가 반환되는

인수가 NaN 의 경우, 반환되는 값은 실제의 NaN 치를 나타내는 정수입니다. floatToIntBits 메소드와는 달라,floatToRawIntBits 메소드가, 모든 비트 패턴 encode NaN 를 단일의 정규 NaN 치에 수납할 것은 없습니다.

어느 경우도, 반환되는 값은 정수형이며,intBitsToFloat(int) 메소드로 지정되었을 경우에,floatToRawIntBits 로 지정된 인수와 같은 부동 소수점치가 생성됩니다.

파라미터:: value - 부동 소수점치
반환값:: 부동 소수점치를 나타내는 비트
도입된 버젼:: 1.3

intBitsToFloat

public static float intBitsToFloat(int bits)

지정된 비트 표현과 대응하는 float 치를 돌려줍니다. 인수는, IEEE 754 부동 소수점 「싱글 포맷 (single format)」비트 배열에 따른 부동 소수점 표현이라고 보여집니다.

인수가 0x7f800000 의 경우는, 정의 무한대가 돌려주어집니다.

인수가 0xff800000 의 경우는, 부의 무한대가 돌려주어집니다.

인수가 0x7f800001 ~ 0x7fffffff 또는 0xff800001 ~ 0xffffffff 의 범위내의 값의 경우, 결과는 NaN 가 됩니다. Java 에 의해 제공되는 IEEE 754 부동 소수점 조작은, 다른 비트 패턴을 가지는 같은 형태의 2 개의 NaN 치를 식별할 수 없습니다. 개별의 NaN 치를 식별할 수 있는 것은,Float.floatToRawIntBits 메소드를 사용하는 경우만입니다.

그 다른 경우에서는,s,e, 및 m 의 3 개의 값에 대해 다음의 인수로부터 계산할 수 있다고 합니다.

 int s = ((bits >> 31) == 0) ?  1 : -1;
 int e = ((bits >> 23) & 0xff);
 int m = (e == 0) ?
                 (bits & 0x7fffff) << 1 :
                 (bits & 0x7fffff) | 0x800000;

이 경우, 부동 소수점치의 결과는, 수식 s·m·2^e-150 의 값과 동일해집니다.

이 메소드는,int 인수와 전혀 같은 비트 패턴을 가지는 float NaN 를 돌려줄 수가 없을 가능성이 있습니다. IEEE 754 에서는, 2 종류의 NaN ( 「시그널을 발생하지 않는 NaN」와「시그널을 발생하는 NaN」)를 구별합니다. 2 종류의 NaN 의 차이는, 일반적으로 Java 에서는 확인할 수 없습니다. 시그널을 발생하는 NaN 에서의 산술 연산에서는, 시그널을 발생하는 NaN 가, 이종이면서 같은 비트 패턴을 가지는 시그널을 발생하지 않는 NaN 로 바뀝니다. 다만, 시그널을 발생하는 NaN 를 단지 카피하는 일부의 프로세서도, 이 변환도 실시합니다. 특히, 시그널을 발생하는 NaN 를 카피해, 호출측의 메소드에 돌려주는 것으로, 이 변환을 실행할 수 있습니다. 따라서,intBitsToFloat 는, 시그널을 발생하는 NaN 비트 패턴을 가지는 float 를 돌려줄 수가 없을 가능성이 있습니다. 그 결과, 일부의 int 치에서는,floatToRawIntBits(intBitsToFloat(start)) 는,start 와 등가가 아닌 경우가 있습니다. 더해, 어느 특정의 비트 패턴이 시그널을 발생하는 NaN 를 나타낼까는, 플랫폼에 따라서 다릅니다. 시그널을 발생하지 않는가 시그널을 발생할까에 관계없이, 모든 NaN 비트 패턴은 위에 나타내는 NaN 의 범위에 없으면 안됩니다.

파라미터:: bits - 정수형
반환값:: 같은 비트 패턴을 가지는 float 부동 소수점치

compareTo

public int compareTo(Float  anotherFloat)

2 개의 Float 객체를 수치적으로 비교합니다. 이 메소드에 의한 비교는, Java 언어의 수치 비교 연산자 (<, <=, ==, >= >)를 프리미티브(primitive) float 치에 적용했을 경우와는 다음의 2 개의 점으로써 다릅니다.

이 메소드에서는,Float.NaN 는 자기 자신에게 동일하고,Float.POSITIVE_INFINITY 를 포함하는 것 외의 모든 float 치보다 크다고 보여진다
이 메소드에서는,0.0f 는 -0. 0f 보다 크다고 보여진다

이렇게 해, 메소드에 의해 적용되는 Float 객체의 자연 순서부로, 「equals 와의 일관성」이 확보됩니다.

정의:: 인터페이스 Comparable <Float > 내의 compareTo

파라미터:: anotherFloat - 비교 대상의 Float
반환값:: anotherFloat 가 이 Float 와 같은 수치의 경우는 값 0. 이 Float 가 anotherFloat 보다 작은 수치의 경우는 0 보다 작은 값. 이 Float 가 anotherFloat 보다 큰 수치의 경우는 0 보다 큰 값
도입된 버젼:: 1.2
관련 항목:: Comparable.compareTo(Object)

compare

public static int compare(float f1,
                          float f2)

지정된 2 개의 float 치를 비교합니다. 반환되는 정수치의 부호는, 다음의 호출로 반환되는 정수의 부호와 같게 됩니다.

new Float(f1). compareTo(new Float(f2))

파라미터:: f1 - 비교하는 최초의 float; f2 - 비교하는 2 번째의 float
반환값:: f1 의 값이 f2 와 동일한 경우는 값 0,f1 의 값이 f2 보다 작은 경우는 0 보다 작은 값,f1 의 값이 f2 보다 큰 경우는 0 보다 큰 값
도입된 버젼:: 1.4

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세 : 필드 | 생성자 | 메소드

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

java.lang 클래스 Float

POSITIVE_INFINITY

NEGATIVE_INFINITY

NaN

MAX_VALUE

MIN_NORMAL

MIN_VALUE

MAX_EXPONENT

MIN_EXPONENT

SIZE

TYPE

Float

Float

Float

toString

toHexString

례

valueOf

valueOf

parseFloat

isNaN

isInfinite

isNaN

isInfinite

toString

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

hashCode

equals

floatToIntBits

floatToRawIntBits

intBitsToFloat

compareTo

compare

java.lang
클래스 Float