الفرق بين المراجعتين ل"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
: وسيط الحد.