介面：字串

rules.字串

介面   靜態

代表字串值的原始型別。

字串可以按照字母順序排列 與 ==、!=、> 相比 <、>= 和 <= 運算子。

字串可以使用 + 運算子串連：

// Concatenate a username and an email domain
'username' + '@domain.com'

子字串可以使用索引運算子 [] 存取。 您也可以使用範圍運算子 [i:j] 來存取這些變數。注意事項 參數 j (範圍運算子中的上限) 為 不包括在內

// Check if the first character of a string is 'a'
mystring[0] == 'a'

// Check if the string starts with 'abc'
mystring[0:3] == 'abc'

布林值、整數、浮點值和空值皆可轉換成字串 使用 string() 函式：

string(true) == "true"
string(1) == "1"
string(2.0) == "2.0"
string(null) == "null"

方法

低

down() 會傳回 rules.String

傳回小寫的輸入字串。

傳回

non-null rules.String 小寫字串。

範例 

'ABC'.lower() == 'abc'
'ABC123'.lower() == 'abc123'

完全相符

match(re) 會傳回 rules.Boolean。

對整個字串執行規則運算式比對。

參數

Re

rules.String

規則運算式 Google RE2 語法。

值不得為空值。
傳回

如果整個字串相符，則傳回 non-null rules.Boolean，否則傳回 false。

範例 

'user@domain.com'.matches('.*@domain[.]com') == true
'banana'.matches('.*@domain[.]com') == false

取代

replace(re, sub) 傳回 rules.String

將符合規則運算式的所有子字串替換為 使用者提供的字串

參數

Re

rules.String

規則運算式 Google RE2 語法。

值不得為空值。

替補球員

rules.String

要替代的字串。

值不得為空值。
傳回

non-null rules.String 代表替換結果的字串 作業。如果沒有與規則運算式相符的子字串，則未修改。 系統會傳回原始字串。

範例 

'banana'.replace("a", "o") == 'bonono'
'banana'.replace("ana", "ee") == 'beena'
'foo@test.com'.replace(".", "-") == '---------------' // '.' regex match all

大小

size() 會傳回 rules.Integer。

傳回字串中的字元數。

傳回

non-null rules.Integer 的字元數。

範例 

'a'.size() == 1
'abc'.size() == 3

斯普利特

Split(re) 會傳回 rules.List

根據規則運算式分割字串。

參數

Re

rules.String

規則運算式 Google RE2 語法。

值不得為空值。
傳回

non-null rules.List 字串清單。

範例 

'a/b/c'.split('/') == ['a', 'b', 'c']

toUtf8

toUtf8() 會傳回 rules.Bytes

傳回字串的 UTF-8 位元組編碼。

傳回

non-null rules.Bytes 包含 UTF-8 編碼的位元組序列 字串表示法

範例 

'**'.toUtf8() == b'\x2A\x2A'
'€'.toUtf8() == b'\xE2\x82\xAC'

剪輯

trim() 會傳回 rules.String

傳回已移除開頭和結尾空格的字串版本。

傳回

non-null rules.String 修剪的字串。

範例 

' a '.trim() == 'a'
'b'.trim() == 'b'

較高

Up() 會傳回 rules.String

傳回輸入字串的大寫版本。

傳回

non-null rules.String：大寫字串。

範例 

'abc'.upper() == 'ABC'
'abc123'.upper() == 'ABC123'