summaryrefslogtreecommitdiffstats
path: root/docs/content/en/functions/go-template/len.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/en/functions/go-template/len.md')
-rw-r--r--docs/content/en/functions/go-template/len.md55
1 files changed, 55 insertions, 0 deletions
diff --git a/docs/content/en/functions/go-template/len.md b/docs/content/en/functions/go-template/len.md
new file mode 100644
index 000000000..b8be621e8
--- /dev/null
+++ b/docs/content/en/functions/go-template/len.md
@@ -0,0 +1,55 @@
+---
+title: len
+description: Returns the length of a string, slice, map, or collection.
+categories: [functions]
+keywords: []
+menu:
+ docs:
+ parent: functions
+function:
+ aliases: []
+ returnType: int
+ signatures: [len INPUT]
+relatedFunctions:
+ - len
+ - strings.Count
+ - strings.CountRunes
+ - strings.CountWords
+ - strings.RuneCount
+aliases: [/functions/len]
+---
+
+{{% readfile file="/functions/_common/go-template-functions.md" %}}
+
+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
+```