modeling-app/docs/kcl-std/functions/std-units-toInches.md

---
title: "units::toInches"
subtitle: "Function in std::units"
excerpt: "Convert a number to inches from its current units."
layout: manual
---

Convert a number to inches from its current units.


### Arguments

| Name | Type | Description | Required |
|----------|------|-------------|----------|
| `num` | [`number(Length)`](/docs/kcl-std/types/std-types-number) | A number. | Yes |

### Returns

[`number(in)`](/docs/kcl-std/types/std-types-number) - A number.


### Function signature

```kcl
units::toInches(@num: number(Length)): number(in)
```