#تنسيق النصوص

يقدم هذا القسم مُنسّقات متنوعة لبيانات النصوص. ستعرض الأقسام الفرعية التالية صيغة كل مُنسّق، أمثلته، ونتائجه.

#1. :lowerCase

#شرح الصيغة

يحول جميع الحروف إلى أحرف صغيرة.

#مثال

'My Car':lowerCase()   // الناتج "my car"
'my car':lowerCase()   // الناتج "my car"
null:lowerCase()       // الناتج null
1203:lowerCase()       // الناتج 1203

#النتيجة

تظهر نتيجة كل مثال كما هو موضح في التعليقات.

#2. :upperCase

#شرح الصيغة

يحول جميع الحروف إلى أحرف كبيرة.

#مثال

'My Car':upperCase()   // الناتج "MY CAR"
'my car':upperCase()   // الناتج "MY CAR"
null:upperCase()       // الناتج null
1203:upperCase()       // الناتج 1203

#النتيجة

تظهر نتيجة كل مثال كما هو موضح في التعليقات.

#3. :ucFirst

#شرح الصيغة

يحول الحرف الأول من السلسلة النصية إلى حرف كبير فقط، مع ترك البقية دون تغيير.

#مثال

'My Car':ucFirst()     // الناتج "My Car"
'my car':ucFirst()     // الناتج "My car"
null:ucFirst()         // الناتج null
undefined:ucFirst()    // الناتج undefined
1203:ucFirst()         // الناتج 1203

#النتيجة

الناتج كما هو موضح في التعليقات.

#4. :ucWords

#شرح الصيغة

يحول الحرف الأول من كل كلمة في السلسلة النصية إلى حرف كبير.

#مثال

'my car':ucWords()     // الناتج "My Car"
'My cAR':ucWords()     // الناتج "My CAR"
null:ucWords()         // الناتج null
undefined:ucWords()    // الناتج undefined
1203:ucWords()         // الناتج 1203

#النتيجة

الناتج كما هو موضح في الأمثلة.

#5. :print(message)

#شرح الصيغة

يعيد دائمًا الرسالة المحددة بغض النظر عن البيانات الأصلية، مما يجعله مفيدًا كمُنسّق احتياطي. المعلمة:

• message: النص المراد طباعته.

#مثال

'My Car':print('hello!')   // الناتج "hello!"
'my car':print('hello!')   // الناتج "hello!"
null:print('hello!')       // الناتج "hello!"
1203:print('hello!')       // الناتج "hello!"

#النتيجة

يعيد السلسلة النصية المحددة "hello!" في جميع الحالات.

#6. :printJSON

#شرح الصيغة

يحول كائنًا أو مصفوفة إلى سلسلة نصية بتنسيق JSON.

#مثال

[{'id':2,'name':'homer'},{'id':3,'name':'bart'}]:printJSON()
// الناتج "[
  {"id": 2, "name": "homer"},
  {"id": 3, "name": "bart"}
]"
'my car':printJSON()   // الناتج ""my car""

#النتيجة

الناتج هو السلسلة النصية بتنسيق JSON للبيانات المعطاة.

#7. :unaccent

#شرح الصيغة

يزيل علامات التشكيل من النص، ويحوله إلى تنسيق خالٍ من التشكيل.

#مثال

'crème brulée':unaccent()   // الناتج "creme brulee"
'CRÈME BRULÉE':unaccent()   // الناتج "CREME BRULEE"
'être':unaccent()           // الناتج "etre"
'éùïêèà':unaccent()       // الناتج "euieea"

#النتيجة

تُظهر جميع الأمثلة النص بعد إزالة علامات التشكيل.

#8. :convCRLF

#شرح الصيغة

يحول أحرف إرجاع المؤشر والسطر الجديد (\r\n أو \n) إلى علامات فواصل أسطر خاصة بالمستند. هذا مفيد لتنسيقات مثل DOCX و PPTX و ODT و ODP و ODS. ملاحظة: عند استخدام :html قبل :convCRLF، يتم تحويل \r\n إلى وسم <br>.

#مثال

// لتنسيق ODT:
'my blue 
 car':convCRLF()    // الناتج "my blue <text:line-break/> car"
'my blue 
 car':convCRLF()    // الناتج "my blue <text:line-break/> car"

// لتنسيق DOCX:
'my blue 
 car':convCRLF()    // الناتج "my blue </w:t><w:br/><w:t> car"
'my blue 
 car':convCRLF()    // الناتج "my blue </w:t><w:br/><w:t> car"

#النتيجة

يُظهر الناتج علامات فواصل الأسطر المناسبة لتنسيق المستند المستهدف.

#9. :substr(begin, end, wordMode)

#شرح الصيغة

يُجري عمليات استخراج جزء من سلسلة نصية، بدءًا من الفهرس begin (المعتمد على الصفر) وينتهي قبل الفهرس end. تتحكم معلمة اختيارية wordMode (قيمة منطقية أو last) فيما إذا كان يجب تجنب تقسيم الكلمة في المنتصف.

#مثال

'foobar':substr(0, 3)            // الناتج "foo"
'foobar':substr(1)               // الناتج "oobar"
'foobar':substr(-2)              // الناتج "ar"
'foobar':substr(2, -1)           // الناتج "oba"
'abcd efg hijklm':substr(0, 11, true)  // الناتج "abcd efg "
'abcd efg hijklm':substr(1, 11, true)  // الناتج "abcd efg "

#النتيجة

الناتج هو الجزء المستخرج من السلسلة النصية وفقًا للمعلمات.

#10. :split(delimiter)

#شرح الصيغة

يقسم سلسلة نصية إلى مصفوفة باستخدام الفاصل المحدد. المعلمة:

• delimiter: سلسلة الفاصل.

#مثال

'abcdefc12':split('c')    // الناتج ["ab", "def", "12"]
1222.1:split('.')         // الناتج ["1222", "1"]
'ab/cd/ef':split('/')      // الناتج ["ab", "cd", "ef"]

#النتيجة

تُظهر الأمثلة مصفوفة مقسمة بواسطة الفاصل المحدد.

#11. :padl(targetLength, padString)

#شرح الصيغة

يحشو الجانب الأيسر من السلسلة النصية بحرف محدد حتى تصل السلسلة النهائية إلى targetLength. إذا كان الطول المستهدف أقل من طول السلسلة الأصلية، فسيتم إرجاع السلسلة الأصلية. المعلمات:

• targetLength: الطول الكلي المطلوب.
• padString: السلسلة النصية المستخدمة للحشو (الافتراضي هو مسافة).

#مثال

'abc':padl(10)              // الناتج "       abc"
'abc':padl(10, 'foo')       // الناتج "foofoofabc"
'abc':padl(6, '123465')     // الناتج "123abc"
'abc':padl(8, '0')          // الناتج "00000abc"
'abc':padl(1)               // الناتج "abc"

#النتيجة

يُظهر كل مثال السلسلة النصية المحشوة من اليسار وفقًا لذلك.

#12. :padr(targetLength, padString)

#شرح الصيغة

يحشو الجانب الأيمن من السلسلة النصية بحرف محدد حتى تصل السلسلة النهائية إلى targetLength. المعلمات هي نفسها الخاصة بـ :padl.

#مثال

'abc':padr(10)              // الناتج "abc       "
'abc':padr(10, 'foo')       // الناتج "abcfoofoof"
'abc':padr(6, '123465')     // الناتج "abc123"
'abc':padr(8, '0')          // الناتج "abc00000"
'abc':padr(1)               // الناتج "abc"

#النتيجة

يُظهر الناتج السلسلة النصية المحشوة من اليمين.

#13. :ellipsis(maximum)

#شرح الصيغة

إذا تجاوز النص العدد المحدد من الأحرف، فإنه يضيف علامة حذف ("...") في النهاية. المعلمة:

• maximum: الحد الأقصى لعدد الأحرف المسموح بها.

#مثال

'abcdef':ellipsis(3)      // الناتج "abc..."
'abcdef':ellipsis(6)      // الناتج "abcdef"
'abcdef':ellipsis(10)     // الناتج "abcdef"

#النتيجة

تُظهر الأمثلة النص المقتطع والمضاف إليه علامة حذف إذا لزم الأمر.

#14. :prepend(textToPrepend)

#شرح الصيغة

يضيف النص المحدد كبادئة إلى بداية السلسلة النصية. المعلمة:

• textToPrepend: النص البادئ.

#مثال

'abcdef':prepend('123')     // الناتج "123abcdef"

#النتيجة

يُظهر الناتج النص مع إضافة البادئة المحددة.

#15. :append(textToAppend)

#شرح الصيغة

يضيف النص المحدد كلاحقة إلى نهاية السلسلة النصية. المعلمة:

• textToAppend: النص اللاحق.

#مثال

'abcdef':append('123')      // الناتج "abcdef123"

#النتيجة

يُظهر الناتج النص مع إضافة اللاحقة المحددة.

#16. :replace(oldText, newText)

#شرح الصيغة

يستبدل جميع تكرارات oldText في النص بـ newText. المعلمات:

• oldText: النص المراد استبداله.
• newText: النص الجديد الذي سيحل محله. ملاحظة: إذا كانت newText بقيمة null، فهذا يشير إلى أنه يجب إزالة النص المطابق.

#مثال

'abcdef abcde':replace('cd', 'OK')    // الناتج "abOKef abOKe"
'abcdef abcde':replace('cd')          // الناتج "abef abe"
'abcdef abcde':replace('cd', null)      // الناتج "abef abe"
'abcdef abcde':replace('cd', 1000)      // الناتج "ab1000ef ab1000e"

#النتيجة

الناتج هو النص بعد استبدال الأجزاء المحددة.

#17. :len

#شرح الصيغة

يعيد طول سلسلة نصية أو مصفوفة.

#مثال

'Hello World':len()     // الناتج 11
'':len()                // الناتج 0
[1,2,3,4,5]:len()       // الناتج 5
[1,'Hello']:len()       // الناتج 2

#النتيجة

يُظهر الناتج الطول المقابل كرقم.

#18. :t

#شرح الصيغة

يترجم النص باستخدام قاموس ترجمة. تعتمد الأمثلة والنتائج على إعدادات قاموس الترجمة الفعلية.

#19. :preserveCharRef

#شرح الصيغة

بشكل افتراضي، تتم إزالة بعض الأحرف غير القانونية من XML (مثل & و > و < وما إلى ذلك). يحافظ هذا المنسّق على مراجع الأحرف (على سبيل المثال، يظل § دون تغيير) وهو مناسب لسيناريوهات إنشاء XML محددة. تعتمد الأمثلة والنتائج على حالة الاستخدام المحددة.