---
title: "dividing(by:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/nsdecimalnumber/dividing(by:)"
---

# dividing(by:)

Divides the number by another given number.

## Declaration

```swift
func dividing(by decimalNumber: NSDecimalNumber) -> NSDecimalNumber
```

## Parameters

- `decimalNumber`: The number by which to divide the receiver.

## Return Value

Return Value A new NSDecimalNumber object whose value is the value of the receiver divided by decimalNumber.

## Discussion

Discussion This method uses the default behavior when handling calculation errors and rounding.

## See Also

### Related Documentation

- [defaultBehavior](foundation/nsdecimalnumber/defaultbehavior.md)

### Performing Arithmetic

- [adding(_:)](foundation/nsdecimalnumber/adding(_:).md)
- [subtracting(_:)](foundation/nsdecimalnumber/subtracting(_:).md)
- [multiplying(by:)](foundation/nsdecimalnumber/multiplying(by:).md)
- [raising(toPower:)](foundation/nsdecimalnumber/raising(topower:).md)
- [multiplying(byPowerOf10:)](foundation/nsdecimalnumber/multiplying(bypowerof10:).md)
- [adding(_:withBehavior:)](foundation/nsdecimalnumber/adding(_:withbehavior:).md)
- [subtracting(_:withBehavior:)](foundation/nsdecimalnumber/subtracting(_:withbehavior:).md)
- [multiplying(by:withBehavior:)](foundation/nsdecimalnumber/multiplying(by:withbehavior:).md)
- [dividing(by:withBehavior:)](foundation/nsdecimalnumber/dividing(by:withbehavior:).md)
- [raising(toPower:withBehavior:)](foundation/nsdecimalnumber/raising(topower:withbehavior:).md)
- [multiplying(byPowerOf10:withBehavior:)](foundation/nsdecimalnumber/multiplying(bypowerof10:withbehavior:).md)