시소당

java.math 클래스 BigInteger

클래스 BigInteger

java.lang.Object 
  java.lang.Number 
      java.math.BigInteger

모든 구현된 인터페이스:

Serializable, Comparable <BigInteger >

public class BigInteger
extends Number 
implements Comparable <BigInteger >

변경이 불가능한, 임의 정밀도의 정수입니다. 모든 연산은, BigInteger 가 (Java 원시적 정수형과 같은) 2 치 보수 표기법으로 나타내졌는지와 같이 동작합니다. BigInteger는 Java 모든 원시적 정수 연산자와 java.lang.Math 관련된 모든 메서드에 동등의 것을 제공합니다. 또, BigInteger는 모듈러 산술, GCD 계산, 소수도 테스트, 소수 생성, 비트 조작, 그 외의 몇개의 조작에 대한 연산도 제공합니다.

산술 연산의 시멘틱스는 「Java 언어 사양」에 정의되고 있도록 Java 정수 산술 연산자를 정확하게 모방합니다. 예를 들어, 제로 제산은 ArithmeticException를 Throw 해, 정의 수에 한 부의 수의 제산은 부 (또는 0)의 잉여를 냅니다. 오버플로우에 관한 사양내의 자세한 것은 모두 무시되어 BigInteger는 연산의 결과의 수락에 필요한 만큼 커집니다.

쉬프트 연산의 시멘틱스는 부의 쉬프트 이동량을 가능하게 하기 위한(해) Java 쉬프트 연산자를 확장하고 있습니다. 부의 쉬프트 이동량을 가지는 오른쪽 쉬프트는 왼쪽 쉬프트가 됩니다. 역의 경우도 같습니다. 부호 없음의 오른쪽 쉬프트 연산자 (>>>)는 이 연산에서는 이 클래스가 제공하는 「무한의 워드 사이즈」추출과 조합하는 미가 거의 없기 때문에 생략해지고 있습니다.

비트 단위의 논리 연산의 시멘틱스는 Java 비트 정수 연산자의 시멘틱스를 정확하게 모방하고 있습니다. 2 항연산자 (and,or,xor)는 연산전에 2 개의 오퍼랜드의 짧은 (분)편에 대해서 암묵적으로 부호 확장을 실시합니다.

비교 연산은 부호 첨부 정수의 비교를 실시합니다. 이것은, Java 관련된 연산자 및 동등의 연산자에 해 행해지는 것 것과 같습니다.

모듈러 산술 연산은, 잉여 계산, 나무승 및 곱셈 역수 계산을 위해서 제공되고 있습니다. 이러한 메서드는 항상 0 으로 (modulus - 1) 사이의 부가 아닌 결과를 돌려줍니다.

비트 연산은, 오퍼랜드의 2 보수 표현의 싱글 비트에 사용합니다. 필요에 따라서, 오퍼랜드의 부호는 지시하는 비트를 가지도록 확장됩니다. 연산중의 BigInteger 와 다른 부호를 가지는 BigInteger를 생성하는 싱글 비트 연산은 없습니다. 이것은, 싱글 비트 연산이 단일의 비트에만 영향을 주어, 이 클래스가 제공하는 「무한의 워드 사이즈」추출에 해, 각 BigInteger 에 선행하는 무한의 「가상 부호 비트」가 존재하기 때문에입니다.

설명을 알기 쉽고 간결하게 하기 위해서, BigInteger 메서드의 설명에서는 전체를 통해 사 코드를 사용합니다. 사 코드식 (i + j) 은, 「값이 BigInteger i 값과 BigInteger j 값의 화인 BigInteger」를 나타냅니다. 사 코드식 (i == j) 은, 「BigInteger i 가 BigInteger j 와 같은 값을 나타내는 경우에만 true 인 것」을 나타냅니다. 다른 사 코드식도 똑같이 해석됩니다.

이 클래스의 메서드 및 생성자는 모두, 입력 파라메이타에 대해서 null 오브젝트 참조가 건네받으면 NullPointerException를 Throw 합니다.

도입된 버젼:

JDK1. 1

관련 항목:

BigDecimal, 직렬화 된 형식