الفرق بين المراجعتين لصفحة: «Twig/split»
< Twig
أسامه-دمراني (نقاش | مساهمات) 1.0: إضافة عنوان الصفحة | 2.0 محتوى الصفحة |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: المرشح split في Twig}}</noinclude> | |||
المرشح <code>split</code> يقسم سلسلة نصية بمحدِّد | المرشح <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 موجبًا فإن المصفوفة المعادة ستحتوي على العدد الأقصى | * إذا كان الوسيط <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>[ | </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 صفحة | * [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: وسيط الحد.