الواجهة: سلسلة

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"

الطُرق

أسفل

Low() يعرض rules.String

تعرض نسخة صغيرة من سلسلة الإدخال.

المرتجعات

non-null rules.String السلسلة الصغيرة.

مثال 

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

التطابقات

يطابق(re) عرض rules.Boolean

تُجري مطابقة تعبير عادي على السلسلة بأكملها.

المعلمة

إعادة

rules.String

تعبير عادي يستخدم بنية Google RE2.

يجب ألا تكون القيمة فارغة.
المرتجعات

non-null rules.Boolean صحيح في حال تطابق السلسلة، وخطأ في الحالات الأخرى.

مثال 

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

استبدال

ترجع السمة replace(re, sub) rules.String

لاستبدال جميع ورود السلاسل الفرعية المطابقة تعبير عادي بـ السلسلة التي يقدّمها المستخدم.

المعلمة

إعادة

rules.String

تعبير عادي يستخدم بنية Google RE2.

يجب ألا تكون القيمة فارغة.

sub

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

سبليت

يؤدي تقسيم(re) إلى rules.List.

لتقسيم سلسلة وفقًا لتعبير عادي.

المعلمة

إعادة

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'

يقتطع

Stream() يعرض rules.String

لعرض نسخة من السلسلة مع إزالة المسافات في البداية والنهاية.

المرتجعات

non-null rules.String السلسلة التي تم اقتطاعها.

مثال 

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

أعلى

first() يعرض rules.String

لعرض نسخة بأحرف كبيرة من سلسلة الإدخال.

المرتجعات

non-null rules.String السلسلة التي تبدأ بالأحرف الكبيرة.

مثال 

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