function str.capitalize
string.capitalize: returns a copy of string S, where the first character (if any) is converted to uppercase; all other characters are converted to lowercase.
function str.codepoints
string.codepoints: returns an iterable of the unicode codepoint of a string.
S.codepoints() returns an iterable value containing the
sequence of integer Unicode code points encoded by the string S.
Each invalid code within the string is treated as if it encodes the
Unicode replacement character, U+FFFD.
By returning an iterable, not a list, the cost of decoding the string
is deferred until actually needed; apply list(...) to the result to
materialize the entire sequence.
function str.count
string.count: count the number of occurrences of a string in another string.
S.count(sub[, start[, end]]) returns the number of occurrences of
sub within the string S, or, if the optional substring indices
start and end are provided, within the designated substring of S.
They are interpreted according to Skylark’s indexing conventions.
This implementation does not count occurrence of sub in the string S
that overlap other occurrence of S (which can happen if some suffix of S
is a prefix of S). For instance, "abababa".count("aba") returns 2
for [aba]a[aba], not counting the middle occurrence: ab[aba]ba
(this is following Python behavior).
function str.elems
string.elems: returns an iterable of the bytes values of a string.
S.elems() returns an iterable value containing the
sequence of numeric bytes values in the string S.
To materialize the entire sequence of bytes, apply list(...) to the
result.
function str.endswith
string.endswith: determine if a string ends with a given suffix.
S.endswith(suffix) reports whether the string S has the specified
suffix.
function str.find
string.find: find a substring in a string.
S.find(sub[, start[, end]]) returns the index of the first
occurrence of the substring sub within S.
If either or both of start or end are specified,
they specify a subrange of S to which the search should be restricted.
They are interpreted according to Skylark’s indexing
conventions.
If no occurrence is found, found returns -1.
function str.format
string.format: format a string.
S.format(*args, **kwargs) returns a version of the format string S
in which bracketed portions {...} are replaced
by arguments from args and kwargs.
Within the format string, a pair of braces {{ or }} is treated as
a literal open or close brace.
Each unpaired open brace must be matched by a close brace }.
The optional text between corresponding open and close braces
specifies which argument to use and how to format it, and consists of
three components, all optional:
a field name, a conversion preceded by ‘!’, and a format specifier
preceded by ‘:’.
x to a
string. It may be either !r, which converts the value using
repr(x), or !s, which converts the value using str(x) and is
the default.
The format specifier, after a colon, specifies field width,
alignment, padding, and numeric precision.
Currently it must be empty, but it is reserved for future use.
function str.index
string.index: search a substring inside a string, failing on not found.
S.index(sub[, start[, end]]) returns the index of the first
occurrence of the substring sub within S, like S.find, except
that if the substring is not found, the operation fails.
function str.isalnum
string.isalnum: test if a string is composed only of letters and digits.
S.isalnum() reports whether the string S is non-empty and consists
only Unicode letters and digits.
function str.isalpha
string.isalpha: test if a string is composed only of letters.
S.isalpha() reports whether the string S is non-empty and consists
only of Unicode letters.
function str.isdigit
string.isdigit: test if a string is composed only of digits.
S.isdigit() reports whether the string S is non-empty and consists
only of Unicode digits.
function str.islower
string.islower: test if all letters of a string are lowercase.
S.islower() reports whether the string S contains at least one cased
Unicode letter, and all such letters are lowercase.
function str.isspace
string.isspace: test if all characters of a string are whitespaces.
S.isspace() reports whether the string S is non-empty and consists
only of Unicode spaces.
function str.istitle
string.istitle: test if the string is title cased.
S.istitle() reports whether the string S contains at least one cased
Unicode letter, and all such letters that begin a word are in title
case.
function str.isupper
string.isupper: test if all letters of a string are uppercase.
S.isupper() reports whether the string S contains at least one cased
Unicode letter, and all such letters are uppercase.
function str.join
string.join: join elements with a separator.
S.join(iterable) returns the string formed by concatenating each
element of its argument, with a copy of the string S between
successive elements. The argument must be an iterable whose elements
are strings.
function str.lower
string.lower: convert a string to all lowercase.
S.lower() returns a copy of the string S with letters converted to
lowercase.
function str.lstrip
string.lstrip: trim leading whitespaces.
S.lstrip() returns a copy of the string S with leading whitespace removed.
In most cases instead of passing an argument you should use removeprefix.
function str.partition
string.partition: partition a string in 3 components
S.partition(x = " ") splits string S into three parts and returns them
as a tuple: the portion before the first occurrence of string x,
x itself, and the portion following it.
If S does not contain x, partition returns (S, "", "").
partition fails if x is not a string, or is the empty string.
function str.removeprefix
string.removeprefix: remove a prefix from a string. Not part of standard Starlark.
If the string starts with the prefix string, return
string[len(prefix):].
Otherwise, return a copy of the original string:
function str.removesuffix
string.removesuffix: remove a prefix from a string. Not part of standard Starlark.
If the string starts with the prefix string, return
string[len(prefix):].
Otherwise, return a copy of the original string:
function str.replace
string.replace: replace all occurrences of a substring.
S.replace(old, new[, count]) returns a copy of string S with all
occurrences of substring old replaced by new. If the optional
argument count, which must be an int, is non-negative, it
specifies a maximum number of occurrences to replace.
function str.rfind
string.rfind: find the last index of a substring.
S.rfind(sub[, start[, end]]) returns the index of the substring sub
within S, like S.find, except that rfind returns the index of
the substring’s last occurrence.
function str.rindex
string.rindex: find the last index of a substring, failing on not found.
S.rindex(sub[, start[, end]]) returns the index of the substring sub
within S, like S.index, except that rindex returns the index of
the substring’s last occurrence.
function str.rpartition
string.rpartition: partition a string in 3 elements.
S.rpartition([x = ' ']) is like partition, but splits S at the
last occurrence of x.
function str.rsplit
string.rsplit: splits a string into substrings.
S.rsplit([sep[, maxsplit]]) splits a string into substrings like
S.split, except that when a maximum number of splits is specified,
rsplit chooses the rightmost splits.
function str.rstrip
string.rstrip: trim trailing whitespace.
S.rstrip() returns a copy of the string S with trailing whitespace removed.
In most cases instead of passing an argument you should use removesuffix.
function str.split
string.split: split a string in substrings.
S.split([sep [, maxsplit]]) returns the list of substrings of S,
splitting at occurrences of the delimiter string sep.
Consecutive occurrences of sep are considered to delimit empty
strings, so 'food'.split('o') returns ['f', '', 'd'].
Splitting an empty string with a specified separator returns [''].
If sep is the empty string, split fails.
If sep is not specified or is None, split uses a different
algorithm: it removes all leading spaces from S
(or trailing spaces in the case of rsplit),
then splits the string around each consecutive non-empty sequence of
Unicode white space characters.
If S consists only of white space, split returns the empty list.
If maxsplit is given and non-negative, it specifies a maximum number
of splits.
function str.splitlines
string.splitlines: return the list of lines of a string.
S.splitlines([keepends]) returns a list whose elements are the
successive lines of S, that is, the strings formed by splitting S at
line terminators (‘\n’, ‘\r’ or ‘\r\n’).
The optional argument, keepends, is interpreted as a Boolean.
If true, line terminators are preserved in the result, though
the final element does not necessarily end with a line terminator.
function str.startswith
string.startswith: test whether a string starts with a given prefix.
S.startswith(suffix) reports whether the string S has the specified
prefix.
function str.strip
string.strip: trim leading and trailing whitespaces.
S.strip() returns a copy of the string S with leading and trailing
whitespace removed.
function str.title
string.title: convert a string to title case.
S.title() returns a copy of the string S with letters converted to
titlecase.
Letters are converted to uppercase at the start of words, lowercase
elsewhere.
function str.upper
string.upper: convert a string to all uppercase.
S.upper() returns a copy of the string S with letters converted to
uppercase.