Long (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

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

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⁶⁴를 가산한 값이 됩니다. 그렇지 않은 경우는 인수에 동일한 값이 됩니다. 이 값은 8 진수 (기수 8)의 ASCII 캐릭터 라인에 변환됩니다. 전에 0 은 붙지 않습니다.

부호 없음의 절대값이 제로의 경우는 단일의 제로 문자 「0」( 「\u0030」)로 나타내집니다. 그렇지 않은 경우는 부호 없음의 절대치를 나타내는 문자의 1 문자눈은 제로가 아닙니다. 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번째의 문자만은 잘못된 값을 나타내기 위해서 마이너스 기호의 ASCII 문자 「-」( 「\u002D」)에서 만나도 괜찮습니다. 이상의 결과 생성된 long값이 리턴됩니다 .

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

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

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번째의 문자만은 잘못된 값을 나타내기 위해서 마이너스 기호의 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 진수를 지정할 수 있습니다.
Sign:: -

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

부의 부호 (옵션)와 기수 지시자의 어느 쪽인지 또는 그 양쪽 모두에 계속되는 문자 순서 ( 「0x」, 「0X」, 「#」, 또는 선두의 제로)는 지정된 기수 (10, 16, 또는 8)로 Long.parseLong 메서드를 사용하는 경우와 같이 구문 분석 됩니다. 이 문자 순서는 정의 수가 아니면 안되어, 그렇지 않은 경우는 NumberFormatException을 발생시킵니다. 지정된 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 객체가 보관 유지하는 원시적 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 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

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

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