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

# multiplying(by:)

Multiplies the number by another given number.

## Declaration

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

## Parameters

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

## Return Value

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

## Discussion

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

## See Also

### Related Documentation

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

### Performing Arithmetic

- [adding(_:)](foundation/nsdecimalnumber/adding(_:).md)
- [subtracting(_:)](foundation/nsdecimalnumber/subtracting(_:).md)
- [dividing(by:)](foundation/nsdecimalnumber/dividing(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)