JavaTM Platform
Standard Ed. 6

java.lang
클래스 Integer

java.lang.Object 
  상위를 확장 java.lang.Number 
      상위를 확장 java.lang.Integer
모든 구현된 인터페이스:
Serializable , Comparable <Integer >


public final class Integer
extends Number
implements Comparable <Integer >

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

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

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

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

필드의 개요
static int MAX_VALUE
          int 로 설정 가능한 최대치 (231-1)를 보관 유지하는 정수
static int MIN_VALUE
          int 로 설정 가능한 최소치 (-231)를 보관 유지하는 정수
static int SIZE
          2 의 보수 바이너리 형식에서 int 치를 나타내는데 사용되는 비트수입니다.
static Class <Integer > TYPE
          int 의 원시형을 나타내는 Class 인스턴스
 
생성자 의 개요
Integer (int value)
          지정된 int 치를 나타내는, 새롭게 할당할 수 있었던 Integer 객체를 구축합니다.
Integer (String  s)
          String 파라미터로 나타나는 int 치를 나타내는, 새롭게 할당할 수 있었던 Integer 객체를 구축합니다.
 
메소드의 개요
static int bitCount (int i)
          지정된 int 치의 2 의 보수 바이너리 표현에서의, 1 의 비트의 수를 돌려줍니다.
 byte byteValue ()
          이 Integer 의 값을 byte 로서 돌려줍니다.
 int compareTo (Integer  anotherInteger)
          2 개의 Integer 객체를 수치적으로 비교합니다.
static Integer decode (String  nm)
          StringInteger 에 디코드합니다.
 double doubleValue ()
          이 Integer 의 값을 double 로서 돌려줍니다.
 boolean equals (Object  obj)
          이 객체가 지정된 객체와 비교합니다.
 float floatValue ()
          이 Integer 의 값을 float 로서 돌려줍니다.
static Integer getInteger (String  nm)
          지정된 이름의 시스템 프로퍼티의 정수치를 판정합니다.
static Integer getInteger (String  nm, int val)
          지정된 이름의 시스템 프로퍼티의 정수치를 판정합니다.
static Integer getInteger (String  nm, Integer  val)
          지정된 이름의 시스템 프로퍼티의 정수치를 돌려줍니다.
 int hashCode ()
          Integer 의 해시 코드를 돌려줍니다.
static int highestOneBit (int i)
          지정된 int 치의 최상정도 ( 「가장 좌측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 int 치.
 int intValue ()
          이 Integer 의 값을 int 로서 돌려줍니다.
 long longValue ()
          이 Integer 의 값을 long 로서 돌려줍니다.
static int lowestOneBit (int i)
          지정된 int 치의 최하정도 ( 「가장 우측」)의 1 의 비트의 위치에 최대로 1 개의 1 의 비트를 가지는 int 치.
static int numberOfLeadingZeros (int i)
          지정된 int 치의 2 의 보수 바이너리 표현으로 최상정도 ( 「가장 좌측」)의 1 의 비트에 선행하는 제로의 비트의 수.
static int numberOfTrailingZeros (int i)
          지정된 int 치의 2 의 보수 바이너리 표현으로 최하정도 ( 「가장 우측」)의 1 비트에 계속되는 제로의 비트의 수.
static int parseInt (String  s)
          캐릭터 라인의 인수를 부호 첨부 10 진수의 정수형으로서 구문 분석 합니다.
static int parseInt (String  s, int radix)
          2 번째의 인수로 지정된 기수를 기초로 해, 캐릭터 라인의 인수를 부호 첨부 정수로서 구문 분석 합니다.
static int reverse (int i)
          지정된 int 치의 2 의 보수 바이너리 표현으로 비트의 순서를 반대로 해 취득된 값을 돌려줍니다.
static int reverseBytes (int i)
          지정된 int 치의 2 의 보수 바이너리 표현으로 바이트의 순서를 반대로 해 취득된 값을 돌려줍니다.
static int rotateLeft (int i, int distance)
          지정된 int 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 왼쪽으로 회전해 취득된 값을 돌려줍니다.
static int rotateRight (int i, int distance)
          지정된 int 치의 2 의 보수 바이너리 표현을 지정한 비트수만큼 오른쪽으로 회전해 취득된 값을 돌려줍니다.
 short shortValue ()
          이 Integer 의 값을 short 로서 돌려줍니다.
static int signum (int i)
          지정된 int 치의 부호 요소를 돌려줍니다 (지정한 값이 부의 경우, 반환값은 -1.
static String toBinaryString (int i)
          정수의 인수의 캐릭터 라인 표현을, 기수 2 의 부호 없음 정수로서 돌려줍니다.
static String toHexString (int i)
          정수의 인수의 캐릭터 라인 표현을, 기수 16 의 부호 없음 정수로서 돌려줍니다.
static String toOctalString (int i)
          정수의 인수의 캐릭터 라인 표현을, 기수 8 의 부호 없음 정수로서 돌려줍니다.
 String toString ()
          이 Integer 의 값을 나타내는 String 객체를 돌려줍니다.
static String toString (int i)
          지정된 정수를 나타내는 String 객체를 돌려줍니다.
static String toString (int i, int radix)
          2 번째의 인수를 기수로서 1 번째의 인수의 캐릭터 라인 표현을 돌려줍니다.
static Integer valueOf (int i)
          지정한 int 치를 나타내는 Integer 인스턴스를 돌려줍니다.
static Integer valueOf (String  s)
          지정된 String 의 값을 보관 유지하는 Integer 객체를 돌려줍니다.
static Integer valueOf (String  s, int radix)
          2 번째의 인수로 지정된 기수를 사용한 구문 분석시에, 지정된 String 로부터 추출된 값을 보관 유지하는 Integer 객체를 돌려줍니다.
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

필드의 상세

MIN_VALUE

public static final int MIN_VALUE
int 로 설정 가능한 최소치 (-231)를 보관 유지하는 정수

관련 항목:
정수 필드치

MAX_VALUE

public static final int MAX_VALUE
int 로 설정 가능한 최대치 (231-1)를 보관 유지하는 정수

관련 항목:
정수 필드치

TYPE

public static final Class <Integer > TYPE
int 의 원시형을 나타내는 Class 인스턴스

도입된 버젼:
JDK1. 1

SIZE

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

도입된 버젼:
1.5
관련 항목:
정수 필드치
생성자 의 상세

Integer

public Integer(int value)
지정된 int 치를 나타내는, 새롭게 할당할 수 있었던 Integer 객체를 구축합니다.

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

Integer

public Integer(String  s)
        throws NumberFormatException 
String 파라미터로 나타나는 int 치를 나타내는, 새롭게 할당할 수 있었던 Integer 객체를 구축합니다. 캐릭터 라인은, 기수 10 으로 parseInt 메소드를 사용하는 것과 완전히 같은 방법으로 int 치에 변환됩니다.

파라미터:
s - Integer 에 변환되는 String
예외:
NumberFormatException - String 가 구문 분석 가능한 정수형을 포함하지 않는 경우
관련 항목:
parseInt(java.lang.String, int)
메소드의 상세

toString

public static String  toString(int 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」가 됩니다. radixN 로 하면(자), 이러한 문자의 1 문자눈으로부터 N 문자눈까지가, 기수 - N 자리수로서 순서에 사용됩니다. 즉, 16 진수 (기수는 16)에 사용되는 자리수의 숫자는 0123456789abcdef 가 됩니다. 대문자를 사용하고 싶은 경우는, 생성된 캐릭터 라인에 대해서 String.toUpperCase() 메소드를 호출할 수가 있습니다.
 Integer.toString(n, 16). toUpperCase()
 

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

toHexString

public static String  toHexString(int i)
정수의 인수의 캐릭터 라인 표현을, 기수 16 의 부호 없음 정수로서 돌려줍니다.

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

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

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

toOctalString

public static String  toOctalString(int i)
정수의 인수의 캐릭터 라인 표현을, 기수 8 의 부호 없음 정수로서 돌려줍니다.

부호 없음 int 치는, 인수가 부의 수의 경우는, 인수에 232 를 가산한 값이 됩니다. 그렇지 않은 경우는, 인수에 동일한 값이 됩니다. long 형의 인수의 캐릭터 라인 표현을, 기수 8 의 부호 없음 정수로서 돌려줍니다.  

부호 없음의 절대치가 제로의 경우는, 단일의 제로 문자 '0' ('\u0030')로 나타내집니다. 그렇지 않은 경우는, 부호 없음의 절대치를 나타내는 문자의 1 문자눈은 제로가 아닙니다. 이 값은, 8 진수 (기수  8)의 ASCII 캐릭터 라인에 변환됩니다.

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

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

toBinaryString

public static String  toBinaryString(int i)
정수의 인수의 캐릭터 라인 표현을, 기수 2 의 부호 없음 정수로서 돌려줍니다.

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

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

toString

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

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

parseInt

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

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

례:

 parseInt("0", 10) returns 0
 parseInt("473", 10) returns 473
 parseInt("-0", 10) returns 0
 parseInt("-FF", 16) returns -255
 parseInt("1100110", 2) returns 102
 parseInt("2147483647", 10) returns 2147483647
 parseInt("-2147483648", 10) returns -2147483648
 parseInt("2147483648", 10) throws a NumberFormatException
 parseInt("99", 8) throws a NumberFormatException
 parseInt("Kona", 10) throws a NumberFormatException
 parseInt("Kona", 27) returns 411787
 

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

parseInt

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

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

valueOf

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

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

new Integer(Integer.parseInt(s, radix))

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

valueOf

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

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

new Integer(Integer.parseInt(s))

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

valueOf

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

파라미터:
i - int
반환값:
i 를 나타내는 Integer 인스턴스
도입된 버젼:
1.5

byteValue

public byte byteValue()
Integer 의 값을 byte 로서 돌려줍니다.

오버라이드(override):
클래스 Number 내의 byteValue
반환값:
이 객체가 나타내는 수치를 byte 형으로 변환한 값

shortValue

public short shortValue()
Integer 의 값을 short 로서 돌려줍니다.

오버라이드(override):
클래스 Number 내의 shortValue
반환값:
이 객체가 나타내는 수치를 short 형으로 변환한 값

intValue

public int intValue()
Integer 의 값을 int 로서 돌려줍니다.

정의:
클래스 Number 내의 intValue
반환값:
이 객체가 나타내는 수치를 int 형으로 변환한 값

longValue

public long longValue()
Integer 의 값을 long 로서 돌려줍니다.

정의:
클래스 Number 내의 longValue
반환값:
이 객체가 나타내는 수치를 long 형으로 변환한 값

floatValue

public float floatValue()
Integer 의 값을 float 로서 돌려줍니다.

정의:
클래스 Number 내의 floatValue
반환값:
이 객체가 나타내는 수치를 float 형으로 변환한 값

doubleValue

public double doubleValue()
Integer 의 값을 double 로서 돌려줍니다.

정의:
클래스 Number 내의 doubleValue
반환값:
이 객체가 나타내는 수치를 double 형으로 변환한 값

toString

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

오버라이드(override):
클래스 Object 내의 toString
반환값:
이 객체의 10 진수 (기수  10)에 의한 캐릭터 라인 표현

hashCode

public int hashCode()
Integer 의 해시 코드를 돌려줍니다.

오버라이드(override):
클래스 Object 내의 hashCode
반환값:
이 객체의 해시 코드값. 이 Integer 객체가 나타내는 원시형 int 치에 동일한
관련 항목:
Object.equals(java.lang.Object) , Hashtable

equals

public boolean equals(Object  obj)
이 객체가 지정된 객체와 비교합니다. 결과가 true 가 되는 것은, 인수가 null 는 아니고, 이 객체와 같은 int 치를 포함한 Integer 객체인 경우만입니다.

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

getInteger

public static Integer  getInteger(String  nm)
지정된 이름의 시스템 프로퍼티의 정수치를 판정합니다.  

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

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

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

getInteger(nm, null)

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

getInteger

public static Integer  getInteger(String  nm,
                                 int val)
지정된 이름의 시스템 프로퍼티의 정수치를 판정합니다.  

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

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

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

getInteger(nm, new Integer(val))
그러나 실제로는, 다음과 같이 구현됩니다.
 Integer result = getInteger(nm, null);
 return (result == null) ?  new Integer(val) : result;
 
이 구현에 의해, 디폴트의 값이 불필요한 경우에,Integer 의 불필요한 할당을 피할 수가 있습니다.

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

getInteger

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

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

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

decode

public static Integer  decode(String  nm)
                      throws NumberFormatException 
StringInteger 에 디코드합니다. 이하의 문법의 10 진수, 16 진수, 및 8 진수를 지정할 수 있습니다.
DecodableString:
Signopt DecimalNumeral
Signopt 0x HexDigits
Signopt 0X HexDigits
Signopt # HexDigits
Signopt 0 OctalDigits

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

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

파라미터:
nm - 디코드 대상의 String
반환값:
nm 에 의해 나타내지는 int 치를 보관 유지하는 Integer 객체
예외:
NumberFormatException - String 가 구문 분석 가능한 정수형을 포함하지 않는 경우
관련 항목:
parseInt(java.lang.String, int)

compareTo

public int compareTo(Integer  anotherInteger)
2 개의 Integer 객체를 수치적으로 비교합니다.

정의:
인터페이스 Comparable <Integer > 내의 compareTo
파라미터:
anotherInteger - 비교 대상의 Integer
반환값:
Integer 가 인수 Integer 와 동일한 경우는 값 0. 이 Integer 가 인수 Integer 보다 작은 수치의 경우는 0 보다 작은 값. 이 Integer 가 인수 Integer 보다 큰 수치의 경우는 0 보다 큰 값 (부호 첨부의 비교)
도입된 버젼:
1.2

highestOneBit

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

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

lowestOneBit

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

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

numberOfLeadingZeros

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

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

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

numberOfTrailingZeros

public static int numberOfTrailingZeros(int i)
지정된 int 치의 2 의 보수 바이너리 표현으로 최하정도 ( 「가장 우측」)의 1 비트에 계속되는 제로의 비트의 수. 지정된 값이 2 의 보수 표현의 1 의 비트를 가지지 않는 경우, 즉 제로에 동일한 경우는 32

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

bitCount

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

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

rotateLeft

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

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

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

rotateRight

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

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

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

reverse

public static int reverse(int i)
지정된 int 치의 2 의 보수 바이너리 표현으로 비트의 순서를 반대로 해 취득된 값을 돌려줍니다.

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

signum

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

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

reverseBytes

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

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

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.