path: root/exampleSite/content/en/documentation/reference/functions/tpl/strings/strings/index.md

---
title: "strings"
linkTitle: "strings"
description: "Strings is Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. "
hugoSymbol: TODO




---















## strings.Chomp {#strings_namespace_chomp}

\([any](/documentation/reference/gotypes/#any)\) → [any](/documentation/reference/gotypes/#any)
{.funcsig}
Chomp returns a copy of s with all trailing newline characters removed.


{{< docs/func-aliases "strings.Chomp" >}}
{{< docs/func-examples "strings.Chomp" >}}







## strings.Contains {#strings_namespace_contains}

\([any](/documentation/reference/gotypes/#any)\) → [bool](/documentation/reference/gotypes/#bool)
{.funcsig}
Contains reports whether substr is in s.


{{< docs/func-aliases "strings.Contains" >}}
{{< docs/func-examples "strings.Contains" >}}







## strings.ContainsAny {#strings_namespace_containsany}

\([any](/documentation/reference/gotypes/#any)\) → [bool](/documentation/reference/gotypes/#bool)
{.funcsig}
ContainsAny reports whether any Unicode code points in chars are within s.


{{< docs/func-aliases "strings.ContainsAny" >}}
{{< docs/func-examples "strings.ContainsAny" >}}







## strings.Count {#strings_namespace_count}

\([any](/documentation/reference/gotypes/#any)\) → [int](/documentation/reference/gotypes/#int)
{.funcsig}
Count counts the number of non-overlapping instances of substr in s.
If substr is an empty string, Count returns 1 + the number of Unicode code points in s.


{{< docs/func-aliases "strings.Count" >}}
{{< docs/func-examples "strings.Count" >}}







## strings.CountRunes {#strings_namespace_countrunes}

\([any](/documentation/reference/gotypes/#any)\) → [int](/documentation/reference/gotypes/#int)
{.funcsig}
CountRunes returns the number of runes in s, excluding whitespace.


{{< docs/func-aliases "strings.CountRunes" >}}
{{< docs/func-examples "strings.CountRunes" >}}







## strings.CountWords {#strings_namespace_countwords}

\([any](/documentation/reference/gotypes/#any)\) → [int](/documentation/reference/gotypes/#int)
{.funcsig}
CountWords returns the approximate word count in s.


{{< docs/func-aliases "strings.CountWords" >}}
{{< docs/func-examples "strings.CountWords" >}}







## strings.FindRE {#strings_namespace_findre}

\([string](/documentation/reference/gotypes/#string)[any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [](/documentation/reference/objects//)
{.funcsig}
FindRE returns a list of strings that match the regular expression. By default all matches
will be included. The number of matches can be limited with an optional third parameter.


{{< docs/func-aliases "strings.FindRE" >}}
{{< docs/func-examples "strings.FindRE" >}}







## strings.FirstUpper {#strings_namespace_firstupper}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
FirstUpper returns a string with the first character as upper case.


{{< docs/func-aliases "strings.FirstUpper" >}}
{{< docs/func-examples "strings.FirstUpper" >}}







## strings.HasPrefix {#strings_namespace_hasprefix}

\([any](/documentation/reference/gotypes/#any)\) → [bool](/documentation/reference/gotypes/#bool)
{.funcsig}
HasPrefix tests whether the input s begins with prefix.


{{< docs/func-aliases "strings.HasPrefix" >}}
{{< docs/func-examples "strings.HasPrefix" >}}







## strings.HasSuffix {#strings_namespace_hassuffix}

\([any](/documentation/reference/gotypes/#any)\) → [bool](/documentation/reference/gotypes/#bool)
{.funcsig}
HasSuffix tests whether the input s begins with suffix.


{{< docs/func-aliases "strings.HasSuffix" >}}
{{< docs/func-examples "strings.HasSuffix" >}}







## strings.Repeat {#strings_namespace_repeat}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
Repeat returns a new string consisting of count copies of the string s.


{{< docs/func-aliases "strings.Repeat" >}}
{{< docs/func-examples "strings.Repeat" >}}







## strings.Replace {#strings_namespace_replace}

\([any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
Replace returns a copy of the string s with all occurrences of old replaced
with new.  The number of replacements can be limited with an optional fourth
parameter.


{{< docs/func-aliases "strings.Replace" >}}
{{< docs/func-examples "strings.Replace" >}}







## strings.ReplaceRE {#strings_namespace_replacere}

\([any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
ReplaceRE returns a copy of s, replacing all matches of the regular
expression pattern with the replacement text repl. The number of replacements
can be limited with an optional fourth parameter.


{{< docs/func-aliases "strings.ReplaceRE" >}}
{{< docs/func-examples "strings.ReplaceRE" >}}







## strings.RuneCount {#strings_namespace_runecount}

\([any](/documentation/reference/gotypes/#any)\) → [int](/documentation/reference/gotypes/#int)
{.funcsig}
RuneCount returns the number of runes in s.


{{< docs/func-aliases "strings.RuneCount" >}}
{{< docs/func-examples "strings.RuneCount" >}}







## strings.SliceString {#strings_namespace_slicestring}

\([any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
SliceString slices a string by specifying a half-open range with
two indices, start and end. 1 and 4 creates a slice including elements 1 through 3.
The end index can be omitted, it defaults to the string's length.


{{< docs/func-aliases "strings.SliceString" >}}
{{< docs/func-examples "strings.SliceString" >}}







## strings.Split {#strings_namespace_split}

\([any](/documentation/reference/gotypes/#any)[string](/documentation/reference/gotypes/#string)\) → [](/documentation/reference/objects//)
{.funcsig}
Split slices an input string into all substrings separated by delimiter.


{{< docs/func-aliases "strings.Split" >}}
{{< docs/func-examples "strings.Split" >}}







## strings.Substr {#strings_namespace_substr}

\([any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
Substr extracts parts of a string, beginning at the character at the specified
position, and returns the specified number of characters.

It normally takes two parameters: start and length.
It can also take one parameter: start, i.e. length is omitted, in which case
the substring starting from start until the end of the string will be returned.

To extract characters from the end of the string, use a negative start number.

In addition, borrowing from the extended behavior described at <a href="http://php.net/substr">http://php.net/substr</a>,
if length is given and is negative, then that many characters will be omitted from
the end of string.


{{< docs/func-aliases "strings.Substr" >}}
{{< docs/func-examples "strings.Substr" >}}







## strings.Title {#strings_namespace_title}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
Title returns a copy of the input s with all Unicode letters that begin words
mapped to their title case.


{{< docs/func-aliases "strings.Title" >}}
{{< docs/func-examples "strings.Title" >}}







## strings.ToLower {#strings_namespace_tolower}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
ToLower returns a copy of the input s with all Unicode letters mapped to their
lower case.


{{< docs/func-aliases "strings.ToLower" >}}
{{< docs/func-examples "strings.ToLower" >}}







## strings.ToUpper {#strings_namespace_toupper}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
ToUpper returns a copy of the input s with all Unicode letters mapped to their
upper case.


{{< docs/func-aliases "strings.ToUpper" >}}
{{< docs/func-examples "strings.ToUpper" >}}







## strings.Trim {#strings_namespace_trim}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
Trim returns a string with all leading and trailing characters defined
contained in cutset removed.


{{< docs/func-aliases "strings.Trim" >}}
{{< docs/func-examples "strings.Trim" >}}







## strings.TrimLeft {#strings_namespace_trimleft}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
TrimLeft returns a slice of the string s with all leading characters
contained in cutset removed.


{{< docs/func-aliases "strings.TrimLeft" >}}
{{< docs/func-examples "strings.TrimLeft" >}}







## strings.TrimPrefix {#strings_namespace_trimprefix}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
TrimPrefix returns s without the provided leading prefix string. If s doesn't
start with prefix, s is returned unchanged.


{{< docs/func-aliases "strings.TrimPrefix" >}}
{{< docs/func-examples "strings.TrimPrefix" >}}







## strings.TrimRight {#strings_namespace_trimright}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
TrimRight returns a slice of the string s with all trailing characters
contained in cutset removed.


{{< docs/func-aliases "strings.TrimRight" >}}
{{< docs/func-examples "strings.TrimRight" >}}







## strings.TrimSuffix {#strings_namespace_trimsuffix}

\([any](/documentation/reference/gotypes/#any)\) → [string](/documentation/reference/gotypes/#string)
{.funcsig}
TrimSuffix returns s without the provided trailing suffix string. If s
doesn't end with suffix, s is returned unchanged.


{{< docs/func-aliases "strings.TrimSuffix" >}}
{{< docs/func-examples "strings.TrimSuffix" >}}







## strings.Truncate {#strings_namespace_truncate}

\([any](/documentation/reference/gotypes/#any)[](/documentation/reference/objects//)\) → [HTML](/documentation/reference/objects/html/template/html)
{.funcsig}
Truncate truncates a given string to the specified length.


{{< docs/func-aliases "strings.Truncate" >}}
{{< docs/func-examples "strings.Truncate" >}}