String

เก็บข้อความที่เขียนในเครื่องหมายคำพูดหรือแปลงด้วย str(value) แก้ไขสตริงเดิมโดยตรงไม่ได้ เมธอดของสตริงคืนค่าใหม่ ตำแหน่งและความยาวนับตามจุดรหัส Unicode: อีโมจิหนึ่งตัวใช้หนึ่งตำแหน่ง แต่ตัวอักษรที่มีเครื่องหมายกำกับแยกหรืออีโมจิที่ประกอบกันอาจใช้หลายตำแหน่ง

รูปแบบคำสั่ง

String

ไม่สามารถสร้างคลาสนี้โดยตรงได้

ค่าที่ส่งกลับ

—

ตัวอย่าง

name = "Start"
if name:
    first_char = name[0]
    text(first_char)

เมธอด

24 เมธอด

String.literal

สร้างข้อความโดยตรงด้วยเครื่องหมายคำพูดเดี่ยวหรือคู่

รูปแบบคำสั่ง

"hello"

พารามิเตอร์

ชื่อคำอธิบาย
textString
String content between quotes.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

String — ค่าสตริงใหม่

ตัวอย่าง

label = "Start"
text(label)

String.cast

แปลงค่าเป็นข้อความ คอลเลกชันขนาดใหญ่หรือค่าที่ซ้อนลึกจะถูกย่อพร้อมเครื่องหมายแสดงส่วนที่ละไว้ ส่วนสตริงที่ส่งมาโดยตรงจะไม่เปลี่ยน

รูปแบบคำสั่ง

str(value, /)

พารามิเตอร์

ชื่อคำอธิบาย
valueAny?
Value to convert into text.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

String — ค่าข้อความที่แปลงแล้ว

ตัวอย่าง

attempt = 3
line = str(attempt)

String.length

นับจำนวนอักขระในสตริง

รูปแบบคำสั่ง

len(string, /)

พารามิเตอร์

ชื่อคำอธิบาย
stringString
String value to count.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Int — จำนวนตัวอักษร

ตัวอย่าง

label = "Play"
count = len(label)        # คืนค่า 4

String.index_access

อ่านหนึ่งอักขระตามตำแหน่ง เริ่มที่ 0 ดัชนีติดลบนับจากท้าย: -1 คือตำแหน่งสุดท้าย

รูปแบบคำสั่ง

string[index]

พารามิเตอร์

ชื่อคำอธิบาย
stringString
Source string.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
indexInt
ตำแหน่งอักขระ: 0 คือตัวแรก และ -1 คือตัวสุดท้าย
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

String — สตริงหนึ่งอักขระ หากตำแหน่งอยู่นอกสตริงจะแจ้ง IndexError

ตัวอย่าง

label = "Play"
first = label[0]          # คืนค่า 'P'
last = label[-1]          # คืนค่า 'y'

String.slice

คืนสตริงใหม่ตั้งแต่ start จนถึงก่อน end ดัชนีติดลบนับจากท้าย หากไม่ระบุขอบเขต จะเลือกทั้งสตริงตามทิศทางของ step

รูปแบบคำสั่ง

string[start:end[:step]]

พารามิเตอร์

ชื่อคำอธิบาย
startInt?
First character index to include.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: start of string
endInt
Stop before this character index.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: end of string
stepInt
Distance between characters. Cannot be 0; negative values read backward.
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 1

ค่าที่ส่งกลับ

String — ชิ้นสตริงใหม่ ยึดเข้ากับช่วงที่มีอยู่

ตัวอย่าง

label = "abcdef"
middle = label[1:4]       # คืนค่า 'bcd'
tail = label[-3:]         # คืนค่า 'def'
reverse = label[::-1]     # คืนค่า 'fedcba'

String.lower_method

Return a lowercase copy of the string.

รูปแบบคำสั่ง

string.lower()

ค่าที่ส่งกลับ

String — Lowercase string.

ตัวอย่าง

label = "PLAY"
text(label.lower())

String.upper_method

Return an uppercase copy of the string.

รูปแบบคำสั่ง

string.upper()

ค่าที่ส่งกลับ

String — Uppercase string.

ตัวอย่าง

label = "play"
text(label.upper())

String.strip_method

Trim whitespace, or the provided characters, from both ends.

รูปแบบคำสั่ง

string.strip(chars=None, /)

พารามิเตอร์

ชื่อคำอธิบาย
charsString?
ลบอักขระใดก็ตามที่อยู่ในชุดนี้ซ้ำ ๆ จากปลายที่เลือก ไม่ได้ลบข้อความ chars ทั้งชุดเป็นคำนำหน้าหรือคำลงท้าย
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

String — Trimmed string.

ตัวอย่าง

label = "  Play  "
clean = label.strip()

String.lstrip_method

Trim whitespace, or the provided characters, from the left side.

รูปแบบคำสั่ง

string.lstrip(chars=None, /)

พารามิเตอร์

ชื่อคำอธิบาย
charsString?
ลบอักขระใดก็ตามที่อยู่ในชุดนี้ซ้ำ ๆ จากปลายที่เลือก ไม่ได้ลบข้อความ chars ทั้งชุดเป็นคำนำหน้าหรือคำลงท้าย
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

String — Left-trimmed string.

ตัวอย่าง

label = "...Play"
clean = label.lstrip(".")

String.rstrip_method

Trim whitespace, or the provided characters, from the right side.

รูปแบบคำสั่ง

string.rstrip(chars=None, /)

พารามิเตอร์

ชื่อคำอธิบาย
charsString?
ลบอักขระใดก็ตามที่อยู่ในชุดนี้ซ้ำ ๆ จากปลายที่เลือก ไม่ได้ลบข้อความ chars ทั้งชุดเป็นคำนำหน้าหรือคำลงท้าย
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

String — Right-trimmed string.

ตัวอย่าง

label = "Play..."
clean = label.rstrip(".")

String.startswith_method

ตรวจว่าส่วนที่เลือกเริ่มต้นด้วย prefix หรือไม่ โดยแยกตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

รูปแบบคำสั่ง

string.startswith(prefix, start=0, stop=len(string), /)

พารามิเตอร์

ชื่อคำอธิบาย
prefixString | tuple
ข้อความหรือ tuple ของข้อความที่เป็นไปได้ คืน True หากมีข้อความใดตรงที่จุดเริ่มต้น
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt?
ตำแหน่งแรกที่รวม เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt?
หยุดก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(string)

ค่าที่ส่งกลับ

Boolean — true when the prefix matches.

ตัวอย่าง

label = "Play"
ready = label.startswith("Pl")

String.endswith_method

ตรวจว่าส่วนที่เลือกลงท้ายด้วย suffix หรือไม่ โดยแยกตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

รูปแบบคำสั่ง

string.endswith(suffix, start=0, stop=len(string), /)

พารามิเตอร์

ชื่อคำอธิบาย
suffixString | tuple
ข้อความหรือ tuple ของข้อความที่เป็นไปได้ คืน True หากมีข้อความใดตรงที่จุดสิ้นสุด
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt?
ตำแหน่งแรกที่รวม เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt?
หยุดก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(string)

ค่าที่ส่งกลับ

Boolean — true when the suffix matches.

ตัวอย่าง

label = "Play"
ready = label.endswith("ay")

String.find_method

Find the first substring index, or return -1 when absent.

รูปแบบคำสั่ง

string.find(sub, start=0, stop=len(string), /)

พารามิเตอร์

ชื่อคำอธิบาย
subString
Substring to find.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt?
ตำแหน่งแรกที่ค้นหา เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt?
หยุดค้นหาก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(string)

ค่าที่ส่งกลับ

Int — ตำแหน่งแรกที่ตรงกันในสตริงต้นฉบับ เริ่มที่ 0 หรือ -1 หากไม่พบ

ตัวอย่าง

label = "start button"
index = label.find("button")

String.index_method

คืนตำแหน่งแรกที่ตรงกันในสตริงต้นฉบับ หรือแจ้ง ValueError หากไม่มี sub ในส่วนที่เลือก

รูปแบบคำสั่ง

string.index(sub, start=0, stop=len(string), /)

พารามิเตอร์

ชื่อคำอธิบาย
subString
Substring that must exist.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt?
ตำแหน่งแรกที่ค้นหา เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt?
หยุดค้นหาก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(string)

ค่าที่ส่งกลับ

Int — First matching index.

ตัวอย่าง

label = "start button"
index = label.index("button")

String.replace_method

Return a copy with occurrences of old text replaced.

รูปแบบคำสั่ง

string.replace(old, new, /, count=-1)

พารามิเตอร์

ชื่อคำอธิบาย
oldString
ข้อความที่จะแทนที่ โดยไม่นับจุดที่ตรงกันซ้อนทับ หากเป็นสตริงว่าง จะแทรก new ที่ขอบระหว่างอักขระ ตามจำนวนที่ count อนุญาต
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
newString
Replacement text.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
countInt
Maximum replacements; negative means all.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: -1

ค่าที่ส่งกลับ

String — Updated string copy.

ตัวอย่าง

label = "start start"
once = label.replace("start", "play", 1)

String.split_method

คืน list ของข้อความที่แบ่งด้วย sep หาก sep=None จะรวมกลุ่มช่องว่างเป็นตัวคั่นเดียวและข้ามช่องว่างต้นข้อความ หลังแบ่งครบ maxsplit จะเก็บส่วนที่เหลือเป็นรายการเดียว

รูปแบบคำสั่ง

string.split(sep=None, maxsplit=-1)

พารามิเตอร์

ชื่อคำอธิบาย
sepString?
ข้อความตัวคั่น หากเป็นสตริงว่างจะแจ้ง ValueError ส่วน None จะแบ่งตามกลุ่มช่องว่างแทน
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None
maxsplitInt
Maximum split count; negative means all.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: -1

ค่าที่ส่งกลับ

list — List of string parts.

ตัวอย่าง

raw = "a,b,c"
parts = raw.split(",")

String.join_method

รวมสตริงจากแหล่งข้อมูลที่วนลูปได้ โดยแทรกสตริงนี้ระหว่างแต่ละรายการ หากรายการใดไม่ใช่สตริงจะแจ้งข้อผิดพลาด

รูปแบบคำสั่ง

string.join(iterable, /)

พารามิเตอร์

ชื่อคำอธิบาย
iterableIterable<String>
String values to join.
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

String — Joined string.

ตัวอย่าง

parts = ["a", "b", "c"]
line = ",".join(parts)

String.count_method

Count non-overlapping substring occurrences.

รูปแบบคำสั่ง

string.count(sub, start=0, stop=len(string), /)

พารามิเตอร์

ชื่อคำอธิบาย
subString
ข้อความที่จะนับ สตริงว่างตรงกับทุกขอบระหว่างอักขระ จึงนับได้เท่ากับความยาวส่วนที่เลือกบวก 1
จำเป็น · ระบุตามตำแหน่งเท่านั้น
ไม่มีค่าเริ่มต้น
startInt?
ตำแหน่งแรกที่เริ่มนับ เริ่มที่ 0 ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: 0
stopInt?
หยุดนับก่อนตำแหน่งนี้ ค่าติดลบนับจากท้าย ขอบเขตที่เกินจะถูกจำกัดให้อยู่ในช่วงที่มี
ไม่บังคับ · ระบุตามตำแหน่งเท่านั้น
ค่าเริ่มต้น: len(string)

ค่าที่ส่งกลับ

Int — Occurrence count.

ตัวอย่าง

label = "banana"
count = label.count("an")

String.isalpha_method

Check whether the string is non-empty and all characters are letters.

รูปแบบคำสั่ง

string.isalpha()

ค่าที่ส่งกลับ

Boolean — true for letters only.

ตัวอย่าง

label = "Play"
ok = label.isalpha()

String.isdigit_method

ตรวจว่าสตริงไม่ว่างและทุกอักขระเป็นเลขโดด Unicode รวมถึงเลขยกกำลังและเลขในวงกลม

รูปแบบคำสั่ง

string.isdigit()

ค่าที่ส่งกลับ

Boolean — true for digits only.

ตัวอย่าง

value = "123"
ok = value.isdigit()

String.isalnum_method

ตรวจว่าสตริงไม่ว่างและทุกอักขระเป็นตัวอักษรหรือตัวเลข Unicode รวมถึงเศษส่วน

รูปแบบคำสั่ง

string.isalnum()

ค่าที่ส่งกลับ

Boolean — True เมื่อมีเฉพาะตัวอักษรหรือตัวเลข และ False เมื่อสตริงว่าง

ตัวอย่าง

value = "A123"
ok = value.isalnum()

String.isspace_method

Check whether the string is non-empty and all characters are whitespace.

รูปแบบคำสั่ง

string.isspace()

ค่าที่ส่งกลับ

Boolean — true for whitespace only.

ตัวอย่าง

value = "   "
ok = value.isspace()

String.for_loop

วนซ้ำอักขระจากซ้ายไปขวา

รูปแบบคำสั่ง

for ch in string:

พารามิเตอร์

ชื่อคำอธิบาย
chString
Current character in the loop.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
stringString
String to iterate.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

None — ไม่มีค่าตอบแทนโดยตรง ดำเนินการหนึ่งครั้งต่อตัวละคร

ตัวอย่าง

word = "Go"
for ch in word:
    text(ch)

String.truthy_check

ตรวจสอบว่าสตริงว่างเปล่าหรือไม่

รูปแบบคำสั่ง

if string | if not string

พารามิเตอร์

ชื่อคำอธิบาย
stringString
String used in the condition.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

Boolean condition — จริงเมื่อไม่ว่างเปล่า เท็จเมื่อว่างเปล่า

ตัวอย่าง

value = ""
if not value:
    text("empty")