---
title: "raising(toPower:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/nsdecimalnumber/raising(topower:)"
---

# raising(toPower:)

Raises the number to a given power.

## Declaration

```swift
func raising(toPower power: Int) -> NSDecimalNumber
```

## Parameters

- `power`: The power to which to raise the receiver.

## Return Value

Return Value A new NSDecimalNumber object whose value is the value of the receiver raised to the power power.

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