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

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

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

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

java.lang
클래스 Long

java.lang.Object 
  java.lang.Number 
      java.lang.Long

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

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

Long 클래스는, 원시형 long 의 값을 객체에 랩 합니다. Long 형의 객체에는, 형태가 long 의 단일 필드가 포함됩니다.

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

구현상의 주의:구현상의 주의점: 「bit twiddling (비트 회전)」메소드 (highestOneBit 나 numberOfTrailingZeros )의 구현은, Henry S. Warren, Jr. 저 「Hacker's Delight」(Addison Wesley, 2002)에 근거하고 있습니다.

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

필드의 개요
`static long`	`MAX_VALUE` `long` 로 설정 가능한 최대치 (2⁶³-1)를 보관 유지하는 정수
`static long`	`MIN_VALUE` `long` 로 설정 가능한 최소치 (-2⁶³)를 보관 유지하는 정수
`static int`	`SIZE` 2 의 보수 바이너리 형식에서 `long` 치를 나타내는데 사용되는 비트수입니다.
`static Class <Long >`	`TYPE` `long` 의 원시형을 나타내는 `Class` 인스턴스

생성자 의 개요
`Long (long value)` 지정된 `long` 의 인수를 나타내는, 새롭게 할당할 수 있었던 `Long` 객체를 구축합니다.
`Long (String s)` `String` 파라미터로 나타나는 `long` 치를 나타내는, 새롭게 할당할 수 있었던 `Long` 객체를 구축합니다.

메소드의 개요
`static int`	`bitCount (long i)` 지정된 `long` 치의 2 의 보수 바이너리 표현에서의, 1 의 비트의 수를 돌려줍니다.
`byte`	`byteValue ()` 이 `Long` 의 값을 `byte` 로서 돌려줍니다.
`int`	`compareTo (Long anotherLong)` 2 개의 `Long` 객체를 수치적으로 비교합니다.
`static Long`	`decode (String nm)` `String` 를 `Long` 에 디코드합니다.
`double`	`doubleValue ()` 이 `Long` 의 값을 `double` 로서 돌려줍니다.
`boolean`	`equals (Object obj)` 이 객체가 지정된 객체와 비교합니다.
`float`	`floatValue ()` 이 `Long` 의 값을 `float` 로서 돌려줍니다.
`static Long`	`getLong (String nm)` 지정된 이름의 시스템 프로퍼티의 `long` 치를 판정합니다.
`static Long`	`getLong (String nm, long val)` 지정된 이름의 시스템 프로퍼티의 `long` 치를 판정합니다.
`static Long`	`getLong (String nm, Long val)` 지정된 이름의 시스템 프로퍼티의 `long` 치를 돌려줍니다.
`int`	`hashCode ()` 이 `Long` 의 해시 코드를 돌려줍니다.
`static long`	`highestOneBit (long i)` 지정된 `long` 치의 최상정도 ( 「가장 좌측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 `long` 치.
`int`	`intValue ()` 이 `Long` 의 값을 `int` 로서 돌려줍니다.
`long`	`longValue ()` 이 `Long` 의 값을 `long` 로서 돌려줍니다.
`static long`	`lowestOneBit (long i)` 지정된 `long` 치의 최하정도 ( 「가장 우측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 `long` 치.
`static int`	`numberOfLeadingZeros (long i)` 지정된 `long` 치의 2 의 보수 바이너리 표현의 최상정도 ( 「가장 좌측」)의 1 의 비트에 선행하는 제로의 비트의 수.
`static int`	`numberOfTrailingZeros (long i)` 지정된 `long` 치의 2 의 보수 바이너리 표현으로 최하정도 ( 「가장 우측」)의 1 비트에 계속되는 제로의 비트의 수.
`static long`	`parseLong (String s)` 캐릭터 라인의 인수를 부호 첨부 10 진수의 `long` 형으로서 구문 분석 합니다.
`static long`	`parseLong (String s, int radix)` 2 번째의 인수로 지정된 기수를 기초로 해, 캐릭터 라인의 인수를 부호 첨부 `long` 로서 구문 분석 합니다.
`static long`	`reverse (long i)` 지정된 `long` 치의 2 의 보수 바이너리 표현으로 비트의 순서를 반대로 해 취득한 값을 돌려줍니다.
`static long`	`reverseBytes (long i)` 지정된 `long` 치의 2 의 보수 바이너리 표현으로 바이트의 순서를 반대로 해 취득된 값을 돌려줍니다.
`static long`	`rotateLeft (long i, int distance)` 지정된 `long` 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 왼쪽으로 회전해 취득된 값을 돌려줍니다.
`static long`	`rotateRight (long i, int distance)` 지정된 `long` 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 오른쪽으로 회전해 취득된 값을 돌려줍니다.
`short`	`shortValue ()` 이 `Long` 의 값을 `short` 로서 돌려줍니다.
`static int`	`signum (long i)` 지정한 `long` 치의 부호 요소를 돌려줍니다 (지정한 값이 부의 경우, 반환값은 -1.
`static String`	`toBinaryString (long i)` `long` 형의 인수의 캐릭터 라인 표현을, 기수 2 의 부호 없음 정수로서 돌려줍니다.
`static String`	`toHexString (long i)` `long` 형의 인수의 캐릭터 라인 표현을, 기수 16 의 부호 없음 정수로서 돌려줍니다.
`static String`	`toOctalString (long i)` `long` 형의 인수의 캐릭터 라인 표현을, 기수 8 의 부호 없음 정수로서 돌려줍니다.
`String`	`toString ()` 이 `Long` 의 값을 나타내는 `String` 객체를 돌려줍니다.
`static String`	`toString (long i)` 지정된 `long` 를 나타내는 `String` 객체를 돌려줍니다.
`static String`	`toString (long i, int radix)` 2 번째의 인수를 기수로서 1 번째의 인수의 캐릭터 라인 표현을 돌려줍니다.
`static Long`	`valueOf (long l)` 지정한 `Long`치를 나타내는`long` 인스턴스를 돌려줍니다.
`static Long`	`valueOf (String s)` 지정된 `String` 의 값을 보관 유지하는 `Long` 객체를 돌려줍니다.
`static Long`	`valueOf (String s, int radix)` 2 번째의 인수로 지정된 기수를 사용한 구문 분석시에, 지정된 `String` 로부터 추출된 값을 보관 유지하는 `Long` 객체를 돌려줍니다.

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

필드의 상세

MIN_VALUE

public static final long MIN_VALUE

long 로 설정 가능한 최소치 (-2⁶³)를 보관 유지하는 정수

관련 항목:: 정수 필드치

MAX_VALUE

public static final long MAX_VALUE

long 로 설정 가능한 최대치 (2⁶³-1)를 보관 유지하는 정수

관련 항목:: 정수 필드치

TYPE

public static final Class <Long > TYPE

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

도입된 버젼:: JDK1. 1

SIZE

public static final int SIZE

2 의 보수 바이너리 형식에서 long 치를 나타내는데 사용되는 비트수입니다.

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

생성자 의 상세

Long

public Long(long value)

지정된 long 의 인수를 나타내는, 새롭게 할당할 수 있었던 Long 객체를 구축합니다.

파라미터:: value - Long 객체가 나타내는 값

Long

public Long(String  s)
     throws NumberFormatException

String 파라미터로 나타나는 long 치를 나타내는, 새롭게 할당할 수 있었던 Long 객체를 구축합니다. 캐릭터 라인은, 기수 10 으로 parseLong 메소드를 사용하는 것과 같이 long 치에 변환됩니다.

파라미터:: s - Long 에 변환되는 String
예외:: NumberFormatException - String 가 구문 분석 가능한 long 치를 포함하지 않는 경우
관련 항목:: parseLong(java.lang.String, int)

메소드의 상세

toString

public static String  toString(long i,
                              int radix)

2 번째의 인수를 기수로서 1 번째의 인수의 캐릭터 라인 표현을 돌려줍니다.

기수가 Character.MIN_RADIX 보다 작은 경우, 혹은 Character.MAX_RADIX 보다 큰 경우는, 대신에 10 을 기수로서 사용합니다.

1 번째의 인수가 부의 수인 경우, 생성된 캐릭터 라인의 1 번째의 요소는 마이너스 기호의 ASCII 문자 「-」( 「\u002d」)이 됩니다. 1 번째의 인수가 부의 수가 아닌 경우, 생성된 캐릭터 라인에는 부호가 붙지 않습니다.

생성된 캐릭터 라인의 나머지의 문자는, 1 번째의 인수의 절대치를 나타냅니다. 절대치가 제로인 경우는, 단일의 제로 문자 「0」( 「\u0030」)로 나타내집니다. 그렇지 않은 경우는, 절대치를 나타내는 문자의 1 번째의 문자는 제로가 아닙니다. 이하의 ASCII 문자를, 숫자의 자리수에 사용합니다.

   0123456789abcdefghijklmnopqrstuvwxyz

이것들은, 「\u0030」~ 「\u0039」라고, 「\u0061」~ 「\u007a」가 됩니다. radix 를 N 로 하면(자), 이러한 문자의 1 문자눈으로부터 N 문자눈까지가, 기수 - N 자리수로서 순서에 사용됩니다. 즉, 16 진수 (기수는 16)에 사용되는 자리수의 숫자는 0123456789abcdef 가 됩니다. 대문자를 사용하고 싶은 경우는, 생성된 캐릭터 라인에 대해서 String.toUpperCase() 메소드를 호출할 수가 있습니다.

 Long.toString(n, 16). toUpperCase()

파라미터:: i - 캐릭터 라인으로 변환하는 long; radix - 캐릭터 라인 표현에 사용하는 기수
반환값:: 지정된 기수에서의, 인수의 캐릭터 라인 표현
관련 항목:: Character.MAX_RADIX , Character.MIN_RADIX

toHexString

public static String  toHexString(long i)

long 형의 인수의 캐릭터 라인 표현을, 기수 16 의 부호 없음 정수로서 돌려줍니다.

인수가 부의 수의 경우는, 부호 없음 long 치는 인수에 2⁶⁴ 를 가산한 값이 됩니다. 그렇지 않은 경우는, 인수에 동일한 값이 됩니다. 이 값은, 16 진수 표기 (기수 16)의 ASCII 캐릭터 라인에 의한 숫자가 됩니다. 전에 0 은 붙지 않습니다. 부호 없음의 절대치가 제로의 경우는, 단일의 제로 문자 「0」( 「\u0030」)로 나타내집니다. 그렇지 않은 경우는, 부호 없음의 절대치를 나타내는 문자의 1 문자눈은 제로가 아닙니다. 16 진수의 자리수에는, 이하의 문자를 사용합니다.

 0123456789abcdef

이것들은 「\u0030」~ 「\u0039」라고, 「\u0061」~ 「\u0066」의 문자입니다. 대문자를 사용하고 싶은 경우는, 생성된 캐릭터 라인에 대해서 String.toUpperCase() 메소드를 호출할 수가 있습니다.

 Long.toHexString(n). toUpperCase()

파라미터:: i - 캐릭터 라인으로 변환하는 long
반환값:: 16 진수 (기수 16)의 인수로 나타내지는 부호 없음 long 치의 캐릭터 라인 표현
도입된 버젼:: JDK 1.0. 2

toOctalString

public static String  toOctalString(long i)

long 형의 인수의 캐릭터 라인 표현을, 기수 8 의 부호 없음 정수로서 돌려줍니다.

인수가 부의 수의 경우는, 부호 없음 long 치는 인수에 2⁶⁴ 를 가산한 값이 됩니다. 그렇지 않은 경우는, 인수에 동일한 값이 됩니다. long 이 값은, 8 진수 (기수 8)의 ASCII 캐릭터 라인에 변환됩니다. 전에 0 은 붙지 않습니다.

부호 없음의 절대치가 제로의 경우는, 단일의 제로 문자 '0' ('\u0030')로 나타내집니다. 그렇지 않은 경우는, 부호 없음의 절대치를 나타내는 문자의 1 문자눈은 제로가 아닙니다. 이하의 ASCII 문자를, 8 진수의 자리수에 사용합니다.

01234567

이것들은,'\u0030' ~ '\u0037' 의 문자입니다.

파라미터:: i - 캐릭터 라인으로 변환하는 long
반환값:: 8 진수 (기수 8)의 인수로 나타내지는 부호 없음 long 치의 캐릭터 라인 표현
도입된 버젼:: JDK 1.0. 2

toBinaryString

public static String  toBinaryString(long i)

long 형의 인수의 캐릭터 라인 표현을, 기수 2 의 부호 없음 정수로서 돌려줍니다.

인수가 부의 수의 경우는, 부호 없음 long 치는 인수에 2⁶⁴ 를 가산한 값이 됩니다. 그렇지 않은 경우는, 인수에 동일한 값이 됩니다. 이 값은, 2 진수 (기수 2)의 ASCII 캐릭터 라인에 변환됩니다. 전에 0 은 붙지 않습니다. 부호 없음의 절대치가 제로의 경우는, 단일의 제로 문자 「0」( 「\u0030」)로 나타내집니다. 그렇지 않은 경우는, 부호 없음의 절대치를 나타내는 문자의 1 문자눈은 제로가 아닙니다. 2 진수의 자리수에는, 「0」( 「\u0030」) 및 「1」( 「\u0031」)이 사용됩니다.

파라미터:: i - 캐릭터 라인으로 변환하는 long
반환값:: 2 진수 (기수 2)의 인수로 나타내지는 부호 없음 long 치의 캐릭터 라인 표현
도입된 버젼:: JDK 1.0. 2

toString

public static String  toString(long i)

지정된 long 를 나타내는 String 객체를 돌려줍니다. 인수는, 부호 첨부 10 진수 표현에 변환되고 나서 캐릭터 라인으로서 돌려주어집니다. 이것은, 인수 및 기수 10 을 toString(long, int) 메소드에의 인수로서 지정했을 경우와 완전히 같습니다.

파라미터:: i - 변환되는 long 치
반환값:: 10 진수 (기수 10)의 인수의 캐릭터 라인 표현

parseLong

public static long parseLong(String  s,
                             int radix)
                      throws NumberFormatException

2 번째의 인수로 지정된 기수를 기초로 해, 캐릭터 라인의 인수를 부호 첨부 long 로서 구문 분석 합니다. 캐릭터 라인에 있는 문자는 모두, 지정된 기수의 자리수에 사용하는 숫자가 아니면 안됩니다. 이것은,Character.digit(char, int) 가 부가 아닌 값을 돌려줄지 어떨지에 의해 조사할 수가 있습니다. 다만, 1 번째의 문자만은, 0 보다 작은 값을 나타내기 위해서(때문에) 마이너스 기호의 ASCII 문자 「-」( 「\u002D」)에서 만나도 괜찮습니다. 결과적으로 얻을 수 있는 long 치가 돌려주어집니다.

L ('\u004C') 또는 l ('\u006C')를 형태 지정자로서 캐릭터 라인의 말미에 붙이는 것은, Java 프로그램 언어의 원시 코드의 경우와는 달라 용서되지 않습니다. 다만, 기수가 22 보다 큰 자리수의 숫자에는,L 또는 l 가 나타납니다.

다음에 드는 상황의 어떤 것인가가 발생했을 경우에,NumberFormatException 형의 예외가 throw 됩니다.

1 번째의 인수가 null 인지, 길이 제로의 캐릭터 라인이다
radix 가 Character.MIN_RADIX 보다 작은지,Character.MAX_RADIX 보다 크다
캐릭터 라인안에, 지정된 기수에 의한 자리수에는 사용할 수 없는 문자가 있다. 다만, 캐릭터 라인의 길이가 1 보다 큰 경우는, 1 번째의 문자가 마이너스 기호 '-' ('\u002d')에서 만나도 상관없다
캐릭터 라인에 의해 나타내지는 값이,long 형의 값은 아니다

례:

 parseLong("0", 10) returns 0L
 parseLong("473", 10) returns 473L
 parseLong("-0", 10) returns 0L
 parseLong("-FF", 16) returns -255L
 parseLong("1100110", 2) returns 102L
 parseLong("99", 8) throws a NumberFormatException
 parseLong("Hazelnut", 10) throws a NumberFormatException
 parseLong("Hazelnut", 36) returns 1356099454469L

파라미터:: s - 구문 분석 대상의 long 표현을 포함한 String; radix - s 의 구문 분석시에 사용하는 기수
반환값:: 지정된 기수에서의, 캐릭터 라인 인수로 나타내지는 long 치
예외:: NumberFormatException - 캐릭터 라인이 구문 분석 가능한 long 치를 포함하지 않는 경우

parseLong

public static long parseLong(String  s)
                      throws NumberFormatException

캐릭터 라인의 인수를 부호 첨부 10 진수의 long 형으로서 구문 분석 합니다. 캐릭터 라인에 있는 문자는 모두, 10 진수가 아니면 안됩니다. 다만, 1 번째의 문자만은, 0 보다 작은 값을 나타내기 위해서(때문에) 마이너스 기호의 ASCII 문자 「-」( 「\u002D」)에서 만나도 괜찮습니다. 결과적으로 얻을 수 있는 long 치가 돌려주어집니다. 이것은, 이 인수와 기수 10 이 parseLong(java.lang.String, int) 메소드에 인수로서 지정되었을 경우와 완전히 같습니다.

L ('\u004C') 또는 l ('\u006C')를 형태 지정자로서 캐릭터 라인의 말미에 붙이는 것은, Java 프로그램의 원시 코드의 경우와는 달라 용서되지 않습니다.

파라미터:: s - 구문 분석 대상의 long 표현을 포함한 String
반환값:: 10 진수의 인수로 나타내지는 long 치
예외:: NumberFormatException - 캐릭터 라인이 구문 분석 가능한 long 치를 포함하지 않는 경우

valueOf

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

2 번째의 인수로 지정된 기수를 사용한 구문 분석시에, 지정된 String 로부터 추출된 값을 보관 유지하는 Long 객체를 돌려줍니다. 최초의 인수는, 2 번째의 인수로 지정된 기수내의 부호 첨부 long 로서 해석됩니다. 이것은, 인수가 parseLong(java.lang.String, int) 메소드에게 건네졌을 경우와 완전히 같습니다. 결과는, 캐릭터 라인에 의해 지정된 long 치를 나타내는 Long 객체가 됩니다.

즉, 이 메소드가 돌려주는 Long 객체의 값은, 다음의 값에 동일해집니다.

new Long(Long.parseLong(s, radix))

파라미터:: s - 해석되는 캐릭터 라인; radix - s 의 해석에 사용하는 기수
반환값:: 지정된 기수에서의, 캐릭터 라인 인수로 나타내지는 값을 보관 유지하는 Long 객체
예외:: NumberFormatException - String 가 구문 분석 가능한 long 치를 포함하지 않는 경우

valueOf

public static Long  valueOf(String  s)
                    throws NumberFormatException

지정된 String 의 값을 보관 유지하는 Long 객체를 돌려줍니다. 인수는, 부호 첨부 10 진수의 long 로서 해석됩니다. 이것은,parseLong(java.lang.String) 메소드에 인수가 지정되었을 경우와 완전히 같습니다. 생성된 결과는, 캐릭터 라인에 의해 지정된 정수치를 나타내는 Long 객체가 됩니다.

즉, 이 메소드가 돌려주는 Long 객체의 값은, 다음의 값에 동일해집니다.

 new Long(Long.parseLong(s))

파라미터:: s - 구문 분석 되는 캐릭터 라인
반환값:: 캐릭터 라인 인수에 의해 나타내지는 값을 보관 유지하는 Long 객체
예외:: NumberFormatException - 캐릭터 라인을 long 로서 구문 분석 할 수 없는 경우

valueOf

public static Long  valueOf(long l)

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

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

decode

public static Long  decode(String  nm)
                   throws NumberFormatException

String 를 Long 에 디코드합니다. 이하의 문법의 10 진수, 16 진수, 및 8 진수를 지정할 수 있습니다.

DecodableString:
Sign_opt DecimalNumeral
Sign_opt 0x HexDigits
Sign_opt 0X HexDigits
Sign_opt # HexDigits
Sign_opt 0 OctalDigits

Sign:
-

DecimalNumeral,HexDigits, 및 OctalDigits 는, 「Java 언어 스펙」의 §3. 10.1 으로 정의되고 있습니다.

부의 부호 (생략 가능)와 기수 지시자의 어느 쪽인지 또는 그 양쪽 모두에 계속되는 문자 순서 ( 「0x」, 「0X」, 「#」, 또는 선두의 제로)는, 지정된 기수 (10, 16, 또는 8)로 Long.parseLong 메소드를 사용하는 경우와 같이 구문 분석 됩니다. 이 문자 순서는 정의 수가 아니면 안되어, 그렇지 않은 경우는 NumberFormatException 가 throw 됩니다. 지정된 String 의 최초의 문자가 부의 부호인 경우, 생성된 결과는 부정됩니다. String 에 공백 문자를 지정할 수 없습니다.

파라미터:: nm - 디코드 대상의 String
반환값:: nm 에 의해 나타내지는 long 치를 보관 유지하는 Long 객체
예외:: NumberFormatException - String 가 구문 분석 가능한 long 치를 포함하지 않는 경우
도입된 버젼:: 1.2
관련 항목:: parseLong(String, int)

byteValue

public byte byteValue()

이 Long 의 값을 byte 로서 돌려줍니다.

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

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

shortValue

public short shortValue()

이 Long 의 값을 short 로서 돌려줍니다.

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

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

intValue

public int intValue()

이 Long 의 값을 int 로서 돌려줍니다.

정의:: 클래스 Number 내의 intValue

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

longValue

public long longValue()

이 Long 의 값을 long 로서 돌려줍니다.

정의:: 클래스 Number 내의 longValue

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

floatValue

public float floatValue()

이 Long 의 값을 float 로서 돌려줍니다.

정의:: 클래스 Number 내의 floatValue

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

doubleValue

public double doubleValue()

이 Long 의 값을 double 로서 돌려줍니다.

정의:: 클래스 Number 내의 doubleValue

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

toString

public String  toString()

이 Long 의 값을 나타내는 String 객체를 돌려줍니다. 값은, 부호 첨부의 10 진수 표현에 변환되어 캐릭터 라인으로서 돌려주어집니다. 이것은,long 치가 toString(long) 메소드의 인수로서 지정되었을 경우와 완전히 같습니다.

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

반환값:: 이 객체의 10 진수 (기수 10)에 의한 캐릭터 라인 표현

hashCode

public int hashCode()

이 Long 의 해시 코드를 돌려줍니다. 생성된 결과는, 이 Long 객체가 보관 유지하는 프리미티브(primitive) long 치의 상위 32 비트와 하위 32 비트의 배타적 논리합입니다. 즉, 해시 코드는 다음의 식의 값이 됩니다.

 (int)(this.longValue()^(this.longValue() >>>32))

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

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

equals

public boolean equals(Object  obj)

이 객체가 지정된 객체와 비교합니다. 결과가 true 가 되는 것은, 인수가 null 는 아니고, 이 객체와 같은 Long 치를 포함한 Long 객체인 경우만입니다.

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

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

getLong

public static Long  getLong(String  nm)

지정된 이름의 시스템 프로퍼티의 long 치를 판정합니다.

1 번째의 인수는, 시스템 프로퍼티의 이름으로서 다루어집니다. 시스템 프로퍼티에는 System.getProperty(java.lang.String) 메소드로 액세스 할 수 있습니다. 다음에 이 프로퍼티의 캐릭터 라인치가 long 치로서 다루어져 이 값을 나타내는 Long 객체가 돌려주어집니다. 가능한 수치 형식에 대해서는,getProperty 의 정의를 참조해 주세요.

지정된 이름을 가지는 프로퍼티이 없는 경우, 지정된 이름이 공백 또는 null 의 경우, 혹은 프로퍼티이 적절한 수치 형식이 아닌 경우는,null 가 돌려주어집니다.

즉, 이 메소드가 돌려주는 Long 객체의 값은, 다음의 값에 동일해집니다.

getLong(nm, null)

파라미터:: nm - 프로퍼티명
반환값:: 프로퍼티의 Long 치
관련 항목:: System.getProperty(java.lang.String) , System.getProperty(java.lang.String, java.lang.String)

getLong

public static Long  getLong(String  nm,
                           long val)

지정된 이름의 시스템 프로퍼티의 long 치를 판정합니다.

2 번째의 인수는 디폴트의 값입니다. 지정된 이름의 프로퍼티이 없는 경우, 해당하는 프로퍼티이 적절한 수치 형식이 아닌 경우, 혹은 지정한 이름이 공백 또는 null 의 경우는,Long 객체가 가리키는 2 번째의 인수가 돌려주어집니다.

즉, 이 메소드가 돌려주는 Long 객체의 값은, 다음의 값에 동일해집니다.

getLong(nm, new Long(val))

그러나 실제로는, 다음과 같이 구현됩니다.

 Long result = getLong(nm, null);
 return (result == null) ?  new Long(val) : result;

이 구현에 의해, 디폴트의 값이 불필요한 경우에,Long 객체의 불필요한 할당을 피할 수가 있습니다.

파라미터:: nm - 프로퍼티명; val - 디폴트 값
반환값:: 프로퍼티의 Long 치
관련 항목:: System.getProperty(java.lang.String) , System.getProperty(java.lang.String, java.lang.String)

getLong

public static Long  getLong(String  nm,
                           Long  val)

지정된 이름의 시스템 프로퍼티의 long 치를 돌려줍니다. 1 번째의 인수는, 시스템 프로퍼티의 이름으로서 다루어집니다. 시스템 프로퍼티에는 System.getProperty(java.lang.String) 메소드로 액세스 할 수 있습니다. 다음에 이 프로퍼티의 캐릭터 라인치가 Long.decode 메소드의 경우와 같이 long 치로서 다루어져 이 값을 나타내는 Long 객체가 돌려주어집니다.

프로퍼티의 값이 ASCII 문자 0x 또는 ASCII 문자 # 로 시작되어, 그 후에 마이너스 부호가 없는 경우는, 값의 나머지는 valueOf(java.lang.String, int) 메소드를 기수 16 으로 사용하는 경우와 완전히 똑같이 16 진정수로서 구문 분석 된다
프로퍼티의 값이 ASCII 문자 0 으로 시작되어, 거기에 다른 문자가 계속되는 경우, 값은 valueOf(java.lang.String, int) 메소드를 기수 8 으로 사용하는 경우와 완전히 똑같이 8 진정수로서 해석된다
상기 이외의 경우, 프로퍼티의 값은 valueOf(java.lang.String, int) 메소드를 기수 10 으로 사용하는 경우와 완전히 똑같이 10 진정수로서 구문 분석 된다

어느 경우에도,L ('\u004C') 또는 l ('\u006C')를 형태 지정자로서 프로퍼티치의 말미에 붙이는 것은, Java 프로그램의 원시 코드의 경우와는 달라 용서되지 않습니다.

2 번째의 인수는 디폴트의 값입니다. 지정된 이름의 프로퍼티이 없는 경우, 해당하는 프로퍼티이 적절한 수치 형식이 아닌 경우, 혹은 지정한 이름이 공백 또는 null 의 경우는, 디폴트 값가 돌려주어집니다.

파라미터:: nm - 프로퍼티명; val - 디폴트 값
반환값:: 프로퍼티의 Long 치
관련 항목:: System.getProperty(java.lang.String) , System.getProperty(java.lang.String, java.lang.String) , decode(java.lang.String)

compareTo

public int compareTo(Long  anotherLong)

2 개의 Long 객체를 수치적으로 비교합니다.

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

파라미터:: anotherLong - 비교 대상의 Long
반환값:: 이 Long 가 인수 Long 와 동일한 경우는 값 0. 이 Long 가 인수 Long 보다 작은 수치의 경우는 0 보다 작은 값. 이 Long 가 인수 Long 보다 큰 수치의 경우는 0 보다 큰 값 (부호 첨부의 비교)
도입된 버젼:: 1.2

highestOneBit

public static long highestOneBit(long i)

지정된 long 치의 최상정도 ( 「가장 좌측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 long 치. 지정된 값이 2 의 보수 바이너리 표현의 1 의 비트를 가지지 않는 경우, 즉 제로에 동일한 경우는 제로를 돌려줍니다.

반환값:: 지정된 값의 최상정도의 1 비트의 위치에 1 개의 1 의 비트를 가지는 long 치. 지정된 값이 제로에 동일한 경우는 제로
도입된 버젼:: 1.5

lowestOneBit

public static long lowestOneBit(long i)

지정된 long 치의 최하정도 ( 「가장 우측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 long 치. 지정된 값이 2 의 보수 바이너리 표현의 1 의 비트를 가지지 않는 경우, 즉 제로에 동일한 경우는 제로를 돌려줍니다.

반환값:: 지정된 값의 최하정도의 1 의 비트의 위치에 1 개의 1 의 비트를 가지는 long 치. 지정된 값이 제로에 동일한 경우는 제로
도입된 버젼:: 1.5

numberOfLeadingZeros

public static int numberOfLeadingZeros(long i)

지정된 long 치의 2 의 보수 바이너리 표현의 최상정도 ( 「가장 좌측」)의 1 의 비트에 선행하는 제로의 비트의 수. 지정된 값이 2 의 보수 표현의 1 의 비트를 가지지 않는 경우, 즉 제로에 동일한 경우는 64 를 돌려줍니다.

이 메소드는, 2 를 바닥으로 하는 대수에 밀접하게 관계하고 있습니다. 모든 정의 long 치 x 의 경우,

floor(log₂(x)) = 63 - numberOfLeadingZeros(x)
ceil(log₂(x)) = 64 - numberOfLeadingZeros(x - 1)

반환값:: 지정된 long 치의 2 의 보수 바이너리 표현으로 최상정도 ( 「가장 좌측」)의 1 의 비트에 선행하는 제로의 비트의 수. 지정된 값이 제로에 동일한 경우는 64
도입된 버젼:: 1.5

numberOfTrailingZeros

public static int numberOfTrailingZeros(long i)

지정된 long 치의 2 의 보수 바이너리 표현으로 최하정도 ( 「가장 우측」)의 1 비트에 계속되는 제로의 비트의 수. 지정된 값이 2 의 보수 표현의 1 의 비트를 가지지 않는 경우, 즉 제로에 동일한 경우는 64 를 돌려줍니다.

반환값:: 지정된 long 치의 2 의 보수 2 진표현의 최하정도 ( 「가장 우측」)의 1 의 비트에 계속되는 제로의 비트의 수. 지정된 값이 제로에 동일한 경우는 64
도입된 버젼:: 1.5

bitCount

public static int bitCount(long i)

지정된 long 치의 2 의 보수 바이너리 표현에서의, 1 의 비트의 수를 돌려줍니다. 이 함수는, 「인구 카운트」라고 불리는 경우가 있습니다.

반환값:: 지정된 long 치의 2 의 보수 바이너리 표현에서의, 1 의 비트의 수
도입된 버젼:: 1.5

rotateLeft

public static long rotateLeft(long i,
                              int distance)

지정된 long 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 왼쪽으로 회전해 취득된 값을 돌려줍니다. 비트는, 좌측 즉 상위에 쉬프트 되어 우측 즉 하위에 들어갑니다.

부의 거리에 의한 좌회전은, 오른쪽 회전과 등가입니다(rotateLeft(val, -distance) == rotateRight(val, distance)). 또, 64 의 배수에 의한 회전은 아무것도 하지 않습니다. 즉, 회전 거리의 마지막 6 비트 이외는, 거리가 부의 경우에서도 모두 무시할 수 있는 (rotateLeft(val, distance) == rotateLeft(val, distance & 0x3F)).

반환값:: 지정된 long 치의 2 의 보수 바이너리 표현이 지정된 비트수만큼 왼쪽으로 회전해 취득한 값
도입된 버젼:: 1.5

rotateRight

public static long rotateRight(long i,
                               int distance)

지정된 long 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 오른쪽으로 회전해 취득된 값을 돌려줍니다. 비트는, 우측 즉 하위에 쉬프트 되어 좌측 즉 상위에 들어갑니다.

부의 거리에 의한 오른쪽 회전은, 좌회전과 등가입니다 (rotateRight(val, -distance) == rotateLeft(val, distance)). 또, 64 의 배수에 의한 회전은 아무것도 하지 않습니다. 즉 회전 거리의 마지막 6 비트 이외의 모든 것은, 거리가 부의 경우에서도 무시할 수 있는 (rotateRight(val, distance) == rotateRight(val, distance & 0x3F)).

반환값:: 지정된 long 치의 2 의 보수 바이너리 표현이 지정된 비트수만큼 오른쪽으로 회전해 취득한 값
도입된 버젼:: 1.5

reverse

public static long reverse(long i)

지정된 long 치의 2 의 보수 바이너리 표현으로 비트의 순서를 반대로 해 취득한 값을 돌려줍니다.

반환값:: 지정된 long 치로 바이트순서를 반대로 해 취득한 값
도입된 버젼:: 1.5

signum

public static int signum(long i)

지정한 long 치의 부호 요소를 돌려줍니다 (지정한 값이 부의 경우, 반환값은 -1. 지정된 값이 제로의 경우는 0. 지정한 값이 정의 경우는 1).

반환값:: 지정된 long 치의 부호 요소
도입된 버젼:: 1.5

reverseBytes

public static long reverseBytes(long i)

지정된 long 치의 2 의 보수 바이너리 표현으로 바이트의 순서를 반대로 해 취득된 값을 돌려줍니다.

반환값:: 지정된 long 치의 바이트순서를 반대로 해 취득된 값
도입된 버젼:: 1.5

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

앞의 클래스 다음의 클래스

프레임 있어 프레임 없음

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

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

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

java.lang 클래스 Long

MIN_VALUE

MAX_VALUE

TYPE

SIZE

Long

Long

toString

toHexString

toOctalString

toBinaryString

toString

parseLong

parseLong

valueOf

valueOf

valueOf

decode

byteValue

shortValue

intValue

longValue

floatValue

doubleValue

toString

hashCode

equals

getLong

getLong

getLong

compareTo

highestOneBit

lowestOneBit

numberOfLeadingZeros

numberOfTrailingZeros

bitCount

rotateLeft

rotateRight

reverse

signum

reverseBytes

java.lang
클래스 Long