tpl/strings: strings.RuneCount

This commit is contained in:
David E. Wheeler
2018-06-04 13:47:03 -04:00
committed by Bjørn Erik Pedersen
parent c3115292a7
commit 019bd5576b
5 changed files with 88 additions and 1 deletions

View File

@@ -0,0 +1,28 @@
---
title: strings.RuneCount
description: Determines the number of runes in a string.
godocref:
date: 2018-06-01
publishdate: 2018-06-01
lastmod: 2018-06-01
categories: [functions]
menu:
docs:
parent: "functions"
keywords: [counting, character count, length, rune length, rune count]
signature: ["strings.RuneCount INPUT"]
workson: []
hugoversion:
relatedfuncs: ["len", "countrunes"]
deprecated: false
aliases: []
---
In contrast with `strings.CountRunes` function, which strips HTML and whitespace before counting runes, `strings.RuneCount` simply counts all the runes in a string. It relies on the Go [`utf8.RuneCountInString`] function.
```
{{ "Hello, 世界" | strings.RuneCount }}
<!-- outputs a content length of 9 runes. -->
```
[`utf8.RuneCount`]: https://golang.org/pkg/unicode/utf8/#RuneCount