carta
vmod_str(3)

vmod_str3

Str vmod

Overview

INT count(STRING s)

Returns the number of ascii characters in S, or -1 if S is null.

BOOL startswith(STRING s1, STRING s2)

Returns true if S1 starts with S2.

BOOL endswith(STRING s1, STRING s2)

Returns true if S1 ends with S2.

BOOL contains(STRING s1, STRING s2)

Returns true if S1 contains S2.

STRING take(STRING s, INT n, INT offset=0)

Returns a string composed of the N first characters of S. If S is shorter than N character, the return string is truncated. If S is NULL, NULL is returned.

A negative offset means "from the end of the string" and a negative n means "left of the offset".

STRING reverse(STRING s)

Reverse s.

STRING split(STRING S, INT n, STRING sep=" t")

Split s and return the n-th token. Characters in sep are separators. A negative n indicate "from the end of the string".

BOOL token_intersect(STRING str1, STRING str2, [STRING separators])

BOOL token_intersect(
   STRING str1,
   STRING str2,
   [STRING separators]
)

Checks if the set tokens in one string intersects the set of tokens in the other string. In other words, it returns true if there is a token which exists in both strings.

If the separators argument is not supplied, the space and comma characters are the separators. Empty tokens are ignored in both strings.

History

  • Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)

From varnish-modules 0.25.0-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.