빅넘버 오브젝트를 대상으로 API의 수행 결과를 반환한다.
| Parameters | Type | Description |
|---|---|---|
| objBigNumber | INSTANCE | 빅넘버 오브젝트 |
| strApiName | STRING | API 이름 |
| Type | Description |
|---|---|
| INSTANCE | 빅넘버 오브젝트 API 호출 결과값 또는 오류 발생시 null |
아래의 설명중 "빅넘버"는 "빅넘버 오브젝트"를 의미한다.
API 호출시 첫번째 파라미터인 빅넘버 오브젝트는 변경되지 않는다.
파라미터로 숫자문자열/빅넘버가 아니고, 숫자 형식으로 지정할 경우, -9007199254740991 ~9007199254740991 범위의 값을 사용해야 한다.
범위를 벗어나는 숫자를 지정한 경우에는 null이 리턴된다.
| API | Parameters | Return Value | Description |
|---|---|---|---|
| abs | 빅넘버 | 절대값으로 변환된 값 | |
| cmp | 대상값(숫자/숫자문자열/빅넘버) | 1/-1/0 | 1: 큼, -1: 작음, 0: 같음 |
| eq | 대상값(숫자/숫자문자열/빅넘버) | true/false | 값이 같은지 여부 |
| gt, gte, lt, lte | 대상값(숫자/숫자문자열/빅넘버) | true/false | 값이 큰지, 크거나 같은지, 작은지, 작거나 같은지 여부 |
| plus, minus, times, div | 대상값(숫자/숫자문자열/빅넘버) | 빅넘버 | 더하기, 빼기, 곱하기, 빼기 수행된 결과값 |
| toString, valueOf | 숫자문자열 | 숫자문자열 변환된 값 (값이 -0인 경우, valueOf -> "-0", toString -> "0") | |
| round |
|
빅넘버 | 소수점 자리수를 기준으로 반올림값 |
| toFixed | 소수점수, 반올림 방법(0:내림, 1:반올림, 2:반내림, 3: 올림) | 숫자문자열 | 소수점 자리수를 기준으로 고정값 |
| mod, pow | 대상값(숫자/숫자문자열/빅넘버) | 빅넘버 | 나머지, 거듭제곱 계산값 |
| sqrt, neg | 빅넘버 | 제곱근, 음수/양수 전환값 |
function btnTest_on_mouseup(objInst)
{
var big_number;
big_number = factory.bignumber("-123123123123123123");
if (!big_number) {
screen.alert("Big Number 오브젝트 생성 오류");
}
else {
factory.consoleprint(factory.bignumberapi(big_number, "abs"));
factory.consoleprint(factory.bignumberapi(big_number, "toString"));
factory.consoleprint(factory.bignumberapi(big_number, "valueOf"));
}
}