Text value collection. Created by string literals or str(value), then read by length/index/loop operations.
StringThis class cannot be constructed directly.
—name = "Start"
if name:
first_char = name[0]
text(first_char)Create text directly with single or double quotes.
"hello"String — A new string value.label = "Start"
text(label)Convert a number, boolean, or other value to text. Large or deeply nested structured values use a bounded preview with explicit omission markers, while a direct string remains unchanged.
str(value, /)| Name | Description |
|---|---|
valueAny? | Value to convert into text. Required · Positional only No default |
String — Converted text value.attempt = 3
line = str(attempt)Count how many characters are in the string.
len(string, /)Int — Character count.label = "Play"
count = len(label) # returns 4Read one character by index. Negative indexes count from the end.
string[index]| Name | Description |
|---|---|
stringString | Source string. Required · Positional or named No default |
indexInt | Character index. Use -1 for the last character. Required · Positional only No default |
String? — One-character string, or None if out of range.label = "Play"
first = label[0] # returns 'P'
last = label[-1] # returns 'y'Copy a substring using Python-style slicing. Omitted bounds use the start or end; negative indexes count from the end.
string[start:end[:step]]| Name | Description |
|---|---|
startInt | First character index to include. Optional · Positional only Default: start of string |
endInt | Stop before this character index. Optional · Positional only Default: end of string |
stepInt | Distance between characters. Cannot be 0; negative values read backward. Optional · Positional only Default: 1 |
String — A new string slice, clamped to the available range.label = "abcdef"
middle = label[1:4] # returns 'bcd'
tail = label[-3:] # returns 'def'
reverse = label[::-1] # returns 'fedcba'Return a lowercase copy of the string.
string.lower()String — Lowercase string.label = "PLAY"
text(label.lower())Return an uppercase copy of the string.
string.upper()String — Uppercase string.label = "play"
text(label.upper())Trim whitespace, or the provided characters, from both ends.
string.strip(chars=None, /)| Name | Description |
|---|---|
charsString? | Characters to trim instead of whitespace. Optional · Positional only Default: None |
String — Trimmed string.label = " Play "
clean = label.strip()Trim whitespace, or the provided characters, from the left side.
string.lstrip(chars=None, /)| Name | Description |
|---|---|
charsString? | Characters to trim instead of whitespace. Optional · Positional only Default: None |
String — Left-trimmed string.label = "...Play"
clean = label.lstrip(".")Trim whitespace, or the provided characters, from the right side.
string.rstrip(chars=None, /)| Name | Description |
|---|---|
charsString? | Characters to trim instead of whitespace. Optional · Positional only Default: None |
String — Right-trimmed string.label = "Play..."
clean = label.rstrip(".")Check whether the selected slice starts with a prefix.
string.startswith(prefix, start=0, stop=len(string), /)| Name | Description |
|---|---|
prefixString | Prefix to test. Required · Positional only No default |
startInt | Start index for the check. Optional · Positional only Default: 0 |
stopInt | Stop index for the check. Optional · Positional only Default: len(string) |
Boolean — true when the prefix matches.label = "Play"
ready = label.startswith("Pl")Check whether the selected slice ends with a suffix.
string.endswith(suffix, start=0, stop=len(string), /)| Name | Description |
|---|---|
suffixString | Suffix to test. Required · Positional only No default |
startInt | Start index for the check. Optional · Positional only Default: 0 |
stopInt | Stop index for the check. Optional · Positional only Default: len(string) |
Boolean — true when the suffix matches.label = "Play"
ready = label.endswith("ay")Find the first substring index, or return -1 when absent.
string.find(sub, start=0, stop=len(string), /)| Name | Description |
|---|---|
subString | Substring to find. Required · Positional only No default |
startInt | Start index for the search. Optional · Positional only Default: 0 |
stopInt | Stop index for the search. Optional · Positional only Default: len(string) |
Int — First matching index, or -1.label = "start button"
index = label.find("button")Find the first substring index and fail visibly when absent.
string.index(sub, start=0, stop=len(string), /)| Name | Description |
|---|---|
subString | Substring that must exist. Required · Positional only No default |
startInt | Start index for the search. Optional · Positional only Default: 0 |
stopInt | Stop index for the search. Optional · Positional only Default: len(string) |
Int — First matching index.label = "start button"
index = label.index("button")Return a copy with occurrences of old text replaced.
string.replace(old, new, count=-1, /)String — Updated string copy.label = "start start"
once = label.replace("start", "play", 1)Split a string into a list of text parts.
string.split(sep=None, maxsplit=-1, /)| Name | Description |
|---|---|
sepString? | Separator text. None splits on whitespace. Optional · Positional only Default: None |
maxsplitInt | Maximum split count; negative means all. Optional · Positional only Default: -1 |
list — List of string parts.raw = "a,b,c"
parts = raw.split(",")Join an iterable of strings using this string as the separator.
string.join(iterable, /)String — Joined string.parts = ["a", "b", "c"]
line = ",".join(parts)Count non-overlapping substring occurrences.
string.count(sub, start=0, stop=len(string), /)| Name | Description |
|---|---|
subString | Substring to count. Required · Positional only No default |
startInt | Start index for the count. Optional · Positional only Default: 0 |
stopInt | Stop index for the count. Optional · Positional only Default: len(string) |
Int — Occurrence count.label = "banana"
count = label.count("an")Check whether the string is non-empty and all characters are letters.
string.isalpha()Boolean — true for letters only.label = "Play"
ok = label.isalpha()Check whether the string is non-empty and all characters are digits.
string.isdigit()Boolean — true for digits only.value = "123"
ok = value.isdigit()Check whether the string is non-empty and all characters are letters or digits.
string.isalnum()Boolean — true for letters or digits only.value = "A123"
ok = value.isalnum()Check whether the string is non-empty and all characters are whitespace.
string.isspace()Boolean — true for whitespace only.value = " "
ok = value.isspace()Iterate characters from left to right.
for ch in string:None — No direct return value. Executes once per character.word = "Go"
for ch in word:
text(ch)Check whether the string is empty or not.
if string | if not stringBoolean condition — true when non-empty, false when empty.value = ""
if not value:
text("empty")