Skip to main content
Version: v2

String Functions

capitalize

capitalize(): str

Capitalizes the first letter of a string

Input example

<b>{{ "hello, world!".capitalize() }}</b>

Output

<b>Hello, world!</b>

contains

contains(substr: str): bool

Returns true if the string contains the given substring, otherwise false. The function is sase-sensitive, so the substring must match the case of the string

Arguments

  1. substr (str) - The substring to search for

Input example

<b>{{ "Hello, World!".contains("World") }}</b>

Output

<b>true</b>
Empty substring

If the substr argument is an empty string, the function will always return true. It's done this way because an empty string is always a substring of any string

decimal

decimal(separator?: str = ".", decimals?: int = 2): str

Converts to a string with a decimal part by appending a decimal separator and the number of decimal places. Here are some rules:

  • When the string is not a number, it will return the string as is
  • When the string is already a decimal number, it will return the string as is
  • When the you use on a string, it will return the string as is if it's not a number

Arguments

  1. separator (str) (optional) - The separator to use for the decimal. Default is "."
  2. decimals (int) (optional) - The number of decimal places add to the number. Default is 2

Input example

<b>{{ "123".decimal() }}</b>

Output

<b>123.00</b>

len

len(): int

Returns the length of the string

Input example

<b>{{ "Hello, World!".len() }}</b>

Output

<b>13</b>

lower

lower(): str

Converts a string to lowercase

Input example

<span>{{ "Hello, World!".lower() }}<span>

Output

<span>hello, world!</span>

raw

raw(): str

Function raw is used to render a string as raw HTML. This is useful when you want to render HTML tags from a string. By default, HTML tags in a string are escaped to prevent XSS attacks

Input example

{{ "<h1>Test</h1>".raw() }}

Output

<h1>Test</h1>

reverse

reverse(): str

Returns a string with the characters reversed

Input example

<b>{{ "stressed".reverse() }}</b>

Output

<b>desserts</b>

split

split(separator?: str = " "): arr

Function split is used to split a string into an array of substrings. It takes an optional argument separator which is used to split the string. If no separator is provided, it defaults to a space

Arguments

  1. separator (str) (optional) - What separator to use to split the string. Default is " " (space)

Input example

<div>{{ "one two".split(" ") }}</div>

Output

<div>one, two</div>

trim

trim(chars?: str = "\t \n\r"): str

Trims a string from spaces and special characters like tabs, spaces and new lines by default. You can pass a argument to trim a specific set of characters from a string

Arguments

  1. chars (str) (optional) - A string of characters to trim from a string. Default is "\t \n\r"

Input example

<span>{{ " Anna ".trim() }}</span>

Output

<span>Anna</span>

truncate

truncate(length: int, ellipsis: str = "..."): str

Returns a string truncated to the given length with an optional ellipsis at the end

Arguments

  1. length (int) - The length to truncate the string to
  2. ellipsis (str) (optional) - The ellipsis to append to the truncated string. Default is "..."

Input example

<b>{{ "Hello, World!".truncate(5) }}</b>

Output

<b>Hello...</b>

upper

upper(): str

Converts a string to uppercase

Input example

<b>{{ "Hello, World!".upper() }}</b>

Output

<b>HELLO, WORLD!</b>