---
title: "unitRaised(toPower:)"
framework: healthkit
role: symbol
role_heading: Instance Method
path: "healthkit/hkunit/unitraised(topower:)"
---

# unitRaised(toPower:)

Creates a complex unit by raising the unit to the given power.

## Declaration

```swift
func unitRaised(toPower power: Int) -> HKUnit
```

## Parameters

- `power`: The power by which to raise the unit.

## Return Value

Return Value A new, complex unit.

## Discussion

Discussion This method creates a new, complex unit by raising the unit this method is called on by the given power. This task is often only one step in a series of operations. For example, you can use this method to create a meters-per-second-squared unit as shown below.

## See Also

### Related Documentation

- [init(from:)](healthkit/hkunit/init(from:)-9qont.md)

### Performing unit math

- [unitMultiplied(by:)](healthkit/hkunit/unitmultiplied(by:).md)
- [unitDivided(by:)](healthkit/hkunit/unitdivided(by:).md)
- [reciprocal()](healthkit/hkunit/reciprocal().md)