الفرق بين المراجعتين ل"Twig/split"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة)
 
ط
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: المرشح split في Twig}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: المرشح split في Twig}}</noinclude>
المرشح <code>split</code>  يقسم سلسلة نصية بمحدِّد معطة ويعيد قائمة من السلاسل النصية:<syntaxhighlight lang="twig">
+
المرشح <code>split</code>  يقسم سلسلة نصية بمحدِّد معطاة ويعيد قائمة من السلاسل النصية:<syntaxhighlight lang="twig">
 
{% set foo = "one,two,three"|split(',') %}
 
{% set foo = "one,two,three"|split(',') %}
 
{# ['one', 'two', 'three'] على foo تحتوي#}
 
{# ['one', 'two', 'three'] على foo تحتوي#}
 
</syntaxhighlight>كما يمكن تمرير وسيط <code>limit</code> كما يلي:
 
</syntaxhighlight>كما يمكن تمرير وسيط <code>limit</code> كما يلي:
  
* إذا كان limit موجبًا فإن المصفوفة المعادة ستحتوي على العدد الأقصى من عناصر limit ويحتوي العنصر الأخير على بقية السلسلة النصية.
+
* إذا كان الوسيط <code>limit</code> موجبًا فإن المصفوفة المعادة ستحتوي على العدد الأقصى المحدد بهذا الوسيط ويحتوي العنصر الأخير على بقية السلسلة النصية.
* أما إذا كان limit سالبًا فتعاد جميع المكونات عدا آخر حد.
+
* أما إذا كان <code>limit</code> سالبًا فتعاد جميع الأجزاء المقسومة عدا آخر <code>limit</code> جزء.
* وإذا كان limit يساوي الصفر فإنه يعامل على أنه يساوي 1.
+
* وإذا كان <code>limit</code> يساوي الصفر فإنه يعامل على أنه يساوي 1.
 
<syntaxhighlight lang="twig">
 
<syntaxhighlight lang="twig">
 
{% set foo = "one,two,three,four,five"|split(',', 3) %}
 
{% set foo = "one,two,three,four,five"|split(',', 3) %}
سطر 17: سطر 17:
 
{% set bar = "aabbcc"|split('', 2) %}
 
{% set bar = "aabbcc"|split('', 2) %}
 
{#  ['aa', 'bb', 'cc'] على bar تحتوي #}
 
{#  ['aa', 'bb', 'cc'] على bar تحتوي #}
</syntaxhighlight>لاحظ أن Twig يستخدم دوال <code>[https://secure.php.net/explode explode]</code> أو <code>[https://secure.php.net/str_split str_split]</code> اللتان من لغة PHP إذا كان المحدِّد فارغًا من أجل تقسيم السلاسل النصية.
+
</syntaxhighlight>لاحظ أن Twig يستخدم دوال <code>[[PHP/explode|explode]]</code> أو <code>[[PHP/str split|str_split]]</code> اللتان من لغة [[PHP]] إذا كان المحدِّد فارغًا من أجل تقسيم السلاسل النصية.
  
 
== الوسائط ==
 
== الوسائط ==
سطر 25: سطر 25:
  
 
== انظر أيضًا ==
 
== انظر أيضًا ==
* [[Twig/intro|مقدمة عن محرك القوالب Twig.]]
+
*[[Twig/intro|مقدمة عن محرك القوالب Twig]]
* [[Twig/advanced|توسيع Twig.]]
+
*[[Twig/advanced|توسيع Twig]]
* [[Twig/internals|المكونات الداخلية لـ Twig.]]
+
*[[Twig/internals|المكونات الداخلية لـ Twig]]
* [[Twig/tags|الوسوم في Twig]].
+
* [[Twig/tags|الوسوم في Twig]]
* [[ Twig/filters|المرشحات في Twig]].
+
*[[ Twig/filters|المرشحات في Twig]]
 
== المصادر ==
 
== المصادر ==
* [https://twig.symfony.com/doc/3.x/filters/split.html صفحة توثيق المرشح split في توثيق Twig الرسمي].
+
* [https://twig.symfony.com/doc/3.x/filters/split.html صفحة المرشح split في توثيق Twig الرسمي]
  
 
[[تصنيف:Twig]]
 
[[تصنيف:Twig]]
 
[[تصنيف:Twig Filters]]
 
[[تصنيف:Twig Filters]]

المراجعة الحالية بتاريخ 08:13، 6 مايو 2021

المرشح split يقسم سلسلة نصية بمحدِّد معطاة ويعيد قائمة من السلاسل النصية:

{% set foo = "one,two,three"|split(',') %}
{# ['one', 'two', 'three'] على foo تحتوي#}

كما يمكن تمرير وسيط limit كما يلي:

  • إذا كان الوسيط limit موجبًا فإن المصفوفة المعادة ستحتوي على العدد الأقصى المحدد بهذا الوسيط ويحتوي العنصر الأخير على بقية السلسلة النصية.
  • أما إذا كان limit سالبًا فتعاد جميع الأجزاء المقسومة عدا آخر limit جزء.
  • وإذا كان limit يساوي الصفر فإنه يعامل على أنه يساوي 1.
{% set foo = "one,two,three,four,five"|split(',', 3) %}
{# ['one', 'two', 'three,four,five'] على foo تحتوي #}

إذا كان المحدِّد سلسلة نصية فارغة، فإن القيمة ستقسَّم إلى أجزاء متساوية، ويُضبط الطول باستخدام وسيط limit، ويكون محرفًا واحدًا افتراضيًا:

{% set foo = "123"|split('') %}
{# ['1', '2', '3'] على foo تحتوي #}

{% set bar = "aabbcc"|split('', 2) %}
{#  ['aa', 'bb', 'cc'] على bar تحتوي #}

لاحظ أن Twig يستخدم دوال explode أو str_split اللتان من لغة PHP إذا كان المحدِّد فارغًا من أجل تقسيم السلاسل النصية.

الوسائط

  • delimiter: المحدِّد.
  • limit: وسيط الحد.

انظر أيضًا

المصادر