Java BigDecimal Divide divide(BigDecimal dividend, BigDecimal divisor, int scale)

Description

Divides two decimals and applies the given scale and a ROUND_HALF_UP.

License

Educational Community License

Parameter

Parameter	Description
dividend	the dividend
divisor	the divisor
scale	the scale for the result

Return

the result of the division after the scale and rounding are applied

Declaration

public static BigDecimal divide(BigDecimal dividend,
        BigDecimal divisor, int scale) 

Method Source Code

//package com.java2s;
/*/*from w w w  . j  a va  2 s .  co m*/
 * Copyright 2009 The Kuali Foundation.
 * 
 * Licensed under the Educational Community License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 * 
 * http://www.opensource.org/licenses/ecl2.php
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

import java.math.BigDecimal;

public class Main {
    /**
     * Divides two decimals and applies the given scale and a ROUND_HALF_UP. This method should be used only for the final result
     * calculation. For example if we have something like this: (axb)/c the rules should be applied to the result of the division
     * only and not all the computations that give us the final result.
     * 
     * @param dividend the dividend
     * @param divisor the divisor
     * @param scale the scale for the result
     * @return the result of the division after the scale and rounding are applied
     */
    public static BigDecimal divide(BigDecimal dividend,
            BigDecimal divisor, int scale) {

        BigDecimal result = BigDecimal.ZERO;

        if (dividend != null && divisor != null
                && !divisor.equals(BigDecimal.ZERO)) {
            result = dividend.divide(divisor, scale,
                    BigDecimal.ROUND_HALF_UP);
        }

        return result;
    }
}

Related

1. divide(BigDecimal amount, BigDecimal divisor)
2. divide(BigDecimal aValue1, BigDecimal aValue2, int scale)
3. divide(BigDecimal bd1, BigDecimal bd2)
4. divide(BigDecimal dividend, BigDecimal divisor)
5. divide(BigDecimal dividend, BigDecimal divisor)
6. divide(BigDecimal left, BigDecimal right)
7. divide(BigDecimal num1, BigDecimal num2, int scale, int mode)
8. divide(BigDecimal num1, BigDecimal num2, int scale, int roundingMode)
9. divide(BigDecimal number1, BigDecimal number2, int decimalPlaces)