العمل مع السلاسل النصية

substring() | endswith() | startswith() | contains() | len() | concat() | splitter() | lower() | upper() | strip() | capitalize() | title() | normalizePhone() | replace() | base64() | base64decode() | urlencode() | urldecode() | hmac_hexdigest() | select_random() | tg_escape()

الأسطورة:

! ****- المعلمات الإلزامية

substring(str, n1, n2) - لقص سلسلة نصية

المعلمات:

! str ****- السلسلة الأصلية

! n1 ****- عدد الأحرف المراد قصها من اليسار (> 0)

n2 - عدد الأحرف المراد قصها من اليمين (< 0)

endswith(str, substr) - للتحقق مما إذا كانت السلسلة تنتهي بالسلسلة الفرعية المعطاة

المعلمات:

! str ****- السلسلة الأصلية - "أين تبحث"

! substr ****- سلسلة البحث - "ماذا تبحث"

startswith(str, substr) - للتحقق مما إذا كانت السلسلة تبدأ بالسلسلة الفرعية المعطاة

المعلمات:

! str ****- السلسلة الأصلية - "أين تبحث"

! substr ****- سلسلة البحث - "ماذا تبحث"

contains(str, substr, registr) – للتحقق مما إذا كانت السلسلة الأولى تحتوي على السلسلة الثانية

المعلمات:

! str ****- السلسلة الأصلية - "أين تبحث"

! substr ****- سلسلة البحث - "ماذا تبحث"

registr - علامة تشير إلى ما إذا كان يجب مراعاة حساسية حالة الأحرف (False تعني عدم مراعاة حالة الأحرف)

len(str) – لحساب عدد الأحرف في سلسلة نصية.

المعلمات:

! str ****- السلسلة الأصلية

concat(str1, str2) – لربط (ضم) السلاسل النصية الممررة كمعلمات

المعلمات:

! str1 ****- السلسلة 1

! str2 ****- السلسلة 2

splitter(str, s, n) - لتقسيم سلسلة نصية إلى أجزاء. ترجع الدالة مصفوفة من العناصر

المعلمات:

! str ****- السلسلة الأصلية

! s ****- محدد السلسلة

n - الحد الأقصى لعدد العناصر

lower(str) – لتحويل سلسلة نصية إلى أحرف صغيرة

المعلمات:

! str ****- السلسلة الأصلية

upper(str) - لتحويل سلسلة نصية إلى أحرف كبيرة

المعلمات:

! str ****- السلسلة الأصلية

strip(str) - لإزالة المسافات البيضاء من طرفي السلسلة

المعلمات:

! str ****- السلسلة الأصلية

capitalize(str) - لاستبدال الحرف الأول من السلسلة بما يعادله بالأحرف الكبيرة (يجعل الحرف الأول من الكلمة كبيرًا).

المعلمات:

! str ****- السلسلة الأصلية

title(str) - لتحويل كل كلمة في السلسلة str بحيث يكون الحرف الأول كبيرًا والباقي صغيرًا

normalizePhone(str) - لتنسيق رقم هاتف إلى نموذج قياسي: يزيل جميع الأحرف غير الرقمية ويستبدل الرقم الأول 8 بـ 7 إذا كان موجودًا

المعلمات:

! str ****- السلسلة الأصلية التي تحتوي على رقم هاتف

replace(str, s1, s2, n) - لاستبدال سلسلة فرعية في سلسلة نصية بسلسلة فرعية أخرى

المعلمات:

! str ****- السلسلة الأصلية

! s1 ****- السلسلة الفرعية المراد استبدالها

! s2 ****- السلسلة الفرعية للاستبدال بها

n - عدد الاستبدالات

base64(str) – لتشفير سلسلة نصية بتنسيق base64

المعلمات:

! str ****- السلسلة الأصلية

base64decode(str) - لفك تشفير base64 إلى سلسلة نصية

المعلمات:

! str ****- السلسلة الأصلية

urlencode(str) - لتشفير سلسلة نصية لجعلها آمنة لنقل HTTP

المعلمات:

! str ****- السلسلة الأصلية

على سبيل المثال: John Smith يصبح John%20Smith، و Anna&Maria تصبح Anna%26Maria

urldecode(str) - لفك تشفير سلسلة نصية مشفرة بعنوان URL

المعلمات:

! str ****- السلسلة الأصلية

على سبيل المثال: John%20Smith سيتم ترجمته كـ John Smith

hmac_hexdigest(secret_key, msg, hash_type) - لتجزئة سلسلة نصية باستخدام 'sha256' أو 'md5' أو 'sha512' أو 'sha1'

المعلمات:

! secret_key - المفتاح\ ! msg - السلسلة المراد تجزئتها\ ! hash_type - نوع التجزئة ('sha256' أو 'md5' أو 'sha512' أو 'sha1')

select_random(str, s) - لاختيار عنصر عشوائي من سلسلة نصية محددة. المعلمة الأولى هي السلسلة التي تحتوي على العناصر، والثانية هي المحدد. القيمة الافتراضية للمعلمة الثانية هي '|'.

المعلمات:

! str ****- السلسلة الأصلية

! s ****- محدد السلسلة (القيمة الافتراضية هي '|')

مثال على الاستخدام:
select_random('first element | second element | another element | and another one')

tg_escape(str) - لتخطي متغير وعرضه في رسالة تيليجرام مع تمكين الترميز. تضيف الدالة شرطة مائلة للخلف قبل الأحرف التالية:
'_'، '*'، '['، ']'، '('، ')'، '~'، ''، '>'، '#'، '+'، '-'، '='، '|'، '{'، '}'، '.'، '!'

المعلمات:

! str ****- السلسلة الأصلية

دعنا نحلل دالة قص السلسلة النصية:

تحديد طول السلسلة:

غالبًا ما تكون الدالة التي تقسم سلسلة نصية إلى أجزاء مطلوبة عند العمل مع الجداول:

معالجة رقم الهاتف:

استبدال سلسلة فرعية في سلسلة نصية: