# `arrayLength`

## Description

Returns the number of elements in an array.

## Syntax

Like many functions in DataPrime, `arrayLength` supports [two notations](https://coralogix.com/docs/dataprime/language-reference/functions-reference/index.md), **function** and **method** notation. These interchangeable forms allow flexibility in how you structure expressions.

```dataprime
arrayLength(array: array<any>): number
```

```dataprime
(array: array<any>).arrayLength(): number
```

## Arguments

| Name  | Type  | Required | Description                               |
| ----- | ----- | -------- | ----------------------------------------- |
| array | array | **true** | The array whose length will be calculated |

## Example

**Use case: Determine the number of jobs waiting to be processed**

Suppose you have a list of jobs in a queue. Consider the following input:

```json
{
    "loading_jobs_waiting": ["loading_job1", "loading_job2", "loading_job3"]
}
```

By applying `arrayLength`, you can find out how many jobs are waiting.

### Example query

```dataprime
create waiting_jobs from arrayLength(loading_jobs_waiting)
```

```dataprime
create waiting_jobs from loading_jobs_waiting.arrayLength()
```

### Example output

The result will include the count of array elements:

```json
{
    "loading_jobs_waiting": ["loading_job1", "loading_job2", "loading_job3"],
    "waiting_jobs": 3
}
```