---
title: "length"
canonical: "https://support.appfire.com/space/PSJ/15487587/length"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | length(str) | **Package** |  |
| **Alias** |  | **Pkg Usage** |  |

## Description

> Macro (excerpt)
> 
> Returns the length of the provided string, 0 if the string is null or has no chars.

Returns the length of the provided string, 0 if the string is null or has no chars.

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| str | String | Yes | Specifies a character expression the Length() returns the number of characters for. |

## Return Type

**Number**

## Example

```
wlen = length("This text is <wlen> characters long");
print("Length is " + wlen);
```

Print **Lenght is 35**

## See also

> Macro (contentbylabel)