str

函數

contains

str.contains(source: string, str: string): bool

檢查源字符串是否包含指定的子字符串。

參數

名稱	類型	預設值	說明
source	string		要在其中搜索的字符串。
str	string		要搜索的子字符串。

返回: bool

---

endswith

str.endswith(source: string, str: string): bool

檢查源字符串是否以指定的子字符串結尾。

參數

名稱	類型	預設值	說明
source	string		要檢查的字符串。
str	string		要搜索的後綴。

返回: bool

---

format

str.format(format: string, values: any): string

使用給定的格式和值格式化字符串。

參數

名稱	類型	預設值	說明
format	string		格式字符串。
values	any		要格式化為字符串的可變數量的值。

返回: string

---

format_time

str.format_time(
    time: int,
    format: string,
    timezone: string = syminfo.timezone
  ): string

根據提供的格式和時區將時間戳（自紀元以來以毫秒為單位）格式化為字符串。 'M'、'd'、'h'、'H'、'm' 和 's' 標記都可以加倍以生成前導零。例如，一月將顯示為帶有“M”的 1，或帶有“MM”的 01。最常用的格式化標記是： 'y' - 年份。使用“yy”輸出年份的最後兩位數字，或使用“yyyy”輸出全部四位數字。 2000 年將是 00（帶有“yy”）或 2000 年（帶有“yyyy”）。 'M' - 月份。不要與小寫“m”混淆，後者代表分鐘。 'd' - 一個月中的某一天。 'a' - AM/PM 後綴。 'h' - 12 小時格式的小時。在此格式中，當天的最後一個小時將是“11”。 'H' - 24 小時格式的小時。在此格式中，當天的最後一個小時將是“23”。 'm' - 分鐘。 's' - 第二。 'S' - 秒的幾分之一。 'Z' - 時區，相對於 UTC 的時針偏移量，前面帶有 '+' 或 '-'。

參數

名稱	類型	預設值	說明
time	int		自格式化紀元以來的時間戳（以毫秒為單位）。
format	string		用於轉換的格式字符串。
timezone	string	syminfo.timezone	用於格式化的時區。

返回: string

---

length

str.length(str: string): int

傳回給定字符串的長度。

參數

名稱	類型	預設值	說明
str	string		待確定長度的字符串。

返回: int

---

lower

str.lower(str: string): string

將字符串中的所有字符轉換為小寫。

參數

名稱	類型	預設值	說明
str	string		要轉換為小寫的字符串。

返回: string

---

match

str.match(source: string, regex: string): string

如果源字符串與 regex 正則表達式匹配，則傳回源字符串的新子字符串，否則傳回空字符串。

參數

名稱	類型	預設值	說明
source	string		要搜索的字符串。
regex	string		要匹配的正則表達式模式。

返回: string — 匹配的子字符串，如果未找到匹配則為空字符串。

---

pos

str.pos(source: string, str: string): int

傳回子字符串在字符串中第一次出現的位置，如果未找到，則傳回 na。

參數

名稱	類型	預設值	說明
source	string		要在其中搜索的字符串。
str	string		要搜索的子字符串。

返回: int — 第一次出現的從零開始的索引，如果未找到，則為 na。

---

repeat

str.repeat(source: string, repeat: int): string

傳回由重複指定次數的源字符串組成的新字符串。

參數

名稱	類型	預設值	說明
source	string		要重複的字符串。
repeat	int		重複字符串的次數。

返回: string

---

replace

str.replace(
    source: string,
    target: string,
    replacement: string,
    occurrence: int = 0
  ): string

用替換子字符串替換源字符串中出現的目標子字符串。

參數

名稱	類型	預設值	說明
source	string		要在其中執行替換的原始字符串。
target	string		要替換的子字符串。
replacement	string		用於替換目標的子字符串。
occurrence	int	0	要替換的目標字符串第 N 次出現。第一個匹配的索引從 0 開始。

返回: string

---

replace_all

str.replace_all(source: string, target: string, replacement: string): string

將源字符串中所有出現的目標子字符串替換為替換子字符串。

參數

名稱	類型	預設值	說明
source	string		要在其中執行替換的原始字符串。
target	string		要替換的子字符串。
replacement	string		用於替換目標的子字符串。

返回: string

---

split

str.split(source: string, separator: string): Array<string>

根據指定的分隔符將源字符串拆分為子字符串陣列。

參數

名稱	類型	預設值	說明
source	string		要分割的字符串。
separator	string		要分割的分隔符字符串。

返回: Array<string>

---

startswith

str.startswith(source: string, str: string): bool

檢查源字符串是否以指定的子字符串開頭。

參數

名稱	類型	預設值	說明
source	string		要檢查的字符串。
str	string		要搜索的前綴。

返回: bool

---

substring

str.substring(source: string, begin_pos: int, end_pos: int): string

傳回源字符串中從 begin_pos 到 end_pos（不包括）的子字符串。

參數

名稱	類型	預設值	說明
source	string		要從中提取的字符串。
begin_pos	int		起始位置（含）。
end_pos	int		結束位置（獨佔）。

返回: string

---

tonumber

str.tonumber(str: string): float

將字符串轉換為浮點數。

參數

名稱	類型	預設值	說明
str	string		要轉換為數字的字符串。

返回: float — 解析的浮點值，如果字符串無法解析為數字，則為 na。

---

tostring

將值轉換為其字符串表示形式。

參數

名稱	類型	預設值	說明
value	int		要轉換的整數值。
format	string		用於轉換的格式字符串。

返回: string

將浮點數轉換為具有給定格式的字符串。

參數

名稱	類型	預設值	說明
value	float		要轉換的浮點值。
format	string		用於轉換的格式字符串。

返回: string

將值轉換為其字符串表示形式。

參數

名稱	類型	預設值	說明
value	int		要轉換為字符串的值。
format	Format		The Format constant controlling formatting.

返回: string

使用 Format 常量將浮點數轉換為字串。

參數

名稱	類型	預設值	說明
value	float		The float value to convert.
format	Format		The Format constant controlling formatting.

返回: string

將值轉換為其字串表示形式。

參數

名稱	類型	預設值	說明
value	T		The value to convert to string.

返回: string

---

trim

str.trim(str: string): string

修剪給定字符串的前導和尾隨空格。

參數

名稱	類型	預設值	說明
str	string		要修剪的字符串。

返回: string

---

upper

str.upper(str: string): string

將字符串中的所有字符轉換為大寫。

參數

名稱	類型	預設值	說明
str	string		要轉換為大寫的字符串。

返回: string