summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/go-template/len.md
blob: 43f150a5ff3499f0629b89d55fff9c5cc9ff6f57 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
---
title: len
description: Returns the length of a string, slice, map, or collection.
categories: []
keywords: []
action:
  aliases: []
  related:
    - functions/strings/Count
    - functions/strings/CountRunes
    - functions/strings/CountWords
    - functions/strings/RuneCount
  returnType: int
  signatures: [len VALUE]
aliases: [/functions/len]
---

With a string:

```go-html-template
{{ "ab" | len }} → 2
{{ "" | len }} → 0
```

With a slice:

```go-html-template
{{ slice "a" "b" | len }} → 2
{{ slice | len }} → 0
```

With a map:

```go-html-template
{{ dict "a" 1 "b" 2  | len }} → 2
{{ dict | len }} → 0
```

With a collection:

```go-html-template
{{ site.RegularPages | len }} → 42
```

You may also determine the number of pages in a collection with:

```go-html-template
{{ site.RegularPages.Len }} → 42
```

{{% include "functions/go-template/_common/text-template.md" %}}