---
schema_version: "1"
id: 3d446b40d34c4c26fdb4f676a8ada50be4aa86f9a8cf9b02e5851d377f8df41e
title: sizeOf
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/dataweave/2.3/dw-core-functions-sizeof.md
canonical_url: https://docs.mulesoft.com/dataweave/2.3/dw-core-functions-sizeof
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 3b15800087adc6201e85f6fd78388348aea2c577faac9449170fa03011ab7e62
description: MuleSoft Documentation Site
release: "2.3"
latest: false
---
---
product: DataWeave
version: 2.3
---

# sizeOf

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

## sizeOf(Array<Any>): Number

Returns the number of elements in an array. It returns `0` if the array is empty.

This version of `sizeOf` takes an array or an array of arrays as input. Other versions act on arrays
of objects, strings, or binary values.

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>array</code></p></td><td><p>The input array. The elements in the array can be any supported type.</p></td></tr></tbody></table>

### Example

This example counts the number of elements in the input array. It returns `3`.

#### Source

```DataWeave
%dw 2.0
output application/json
---
sizeOf([ "a", "b", "c"])
```

#### Output

```JSON
3
```

### Example

This example returns a count of elements in the input array.

#### Source

```DataWeave
%dw 2.0
output application/json
---
{
  "arraySizes": {
     size3: sizeOf([1,2,3]),
     size2: sizeOf([[1,2,3],[4]]),
     size0: sizeOf([])
   }
}
```

#### Output

```JSON
{
   "arraySizes": {
     "size3": 3,
     "size2": 2,
     "size0": 0
   }
}
```

## sizeOf(Object): Number

Returns the number of key-value pairs in an object.

This function accepts an array of objects. Returns `0` if the input object is empty.

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>object</code></p></td><td><p>The input object that contains one or more key-value pairs.</p></td></tr></tbody></table>

### Example

This example counts the key-value pairs in the input object, so it returns `2`.

#### Source

```DataWeave
%dw 2.0
output application/json
---
sizeOf({a: 1, b: 2})
```

#### Output

```JSON
2
```

### Example

This example counts the key-value pairs in an object.

#### Source

```DataWeave
%dw 2.0
output application/json
---
{
   objectSizes : {
     sizeIs2: sizeOf({a:1,b:2}),
     sizeIs0: sizeOf({})
   }
}
```

#### Output

```JSON
{
  "objectSize": {
    "sizeIs2": 2,
    "sizeIs0": 0
  }
}
```

## sizeOf(Binary): Number

Returns the number of elements in an array of binary values.

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>binary</code></p></td><td><p>The input array of binary values.</p></td></tr></tbody></table>

### Example

This example returns the size of an array of binary values.

#### Source

```DataWeave
%dw 2.0
output application/json
---
sizeOf(["\u0000" as Binary, "\u0001" as Binary, "\u0002" as Binary])
```

#### Output

```JSON
3
```

## sizeOf(String): Number

Returns the number of characters (including white space) in an string.

Returns `0` if the string is empty.

### Parameters

<table><colgroup><col> <col></colgroup><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr><td><p><code>text</code></p></td><td><p>The input text.</p></td></tr></tbody></table>

### Example

This example returns the number of characters in the input string `"abc"`.

#### Source

```DataWeave
%dw 2.0
output application/json
---
sizeOf("abc")
```

#### Output

```JSON
3
```

### Example

This example returns the number of characters in the input strings. Notice it counts blank spaces in
the string `"my string"` and that `sizeOf("123" as Number)` returns `1` because `123` is coerced
into a number, so it is not a string.

#### Source

```DataWeave
%dw 2.0
output application/json
---
{
  sizeOfSting2 : sizeOf("my string"),
  sizeOfEmptyString: sizeOf(""),
  sizeOfNumber : sizeOf("123" as Number)
}
```

#### Output

```JSON
{
  "sizeOfSting2": 9,
  "sizeOfEmptyString": 0,
  "sizeOfNumber": 1
}
```