الفرق بين المراجعتين ل"Arduino/stringobject/substring"
< Arduino | stringobject
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (أنشأ الصفحة ب'تجلب الدالة <code>substring()</code> جزءًا محدَّدًا من السلسلة النصية التي استدعيت معها....') |
جميل-بيلوني (نقاش | مساهمات) (إضافة محتويات الصفحة.) |
||
| سطر 1: | سطر 1: | ||
| − | + | <noinclude>{{DISPLAYTITLE:التابع <code>String.substring()</code> في أردوينو}}</noinclude> | |
| − | + | يجلب التابع <code>substring()</code> جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه. | |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="arduino"> | <syntaxhighlight lang="arduino"> | ||
| سطر 7: | سطر 7: | ||
string.substring(from, to) | string.substring(from, to) | ||
</syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] التي سيُجلَب منها الجزء المحدَّد بالمعامل <code>from</code> وحتى نهاية السلسلة أو حتى المعامل <code>to</code> إن أعطي. | </syntaxhighlight>تمثِّل <code>string</code> [[Arduino/stringobject|السلسلة النصية]] التي سيُجلَب منها الجزء المحدَّد بالمعامل <code>from</code> وحتى نهاية السلسلة أو حتى المعامل <code>to</code> إن أعطي. | ||
| − | |||
==المعاملات== | ==المعاملات== | ||
===<code>from</code>=== | ===<code>from</code>=== | ||
فهرس [[Arduino/char|المحرف]] الذي يحدِّد بداية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. يدخل هذا [[Arduino/char|المحرف]] ضمن المجال المعاد. | فهرس [[Arduino/char|المحرف]] الذي يحدِّد بداية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. يدخل هذا [[Arduino/char|المحرف]] ضمن المجال المعاد. | ||
| − | + | ===<code>to</code>=== | |
| − | === <code>to</code> === | + | فهرس [[Arduino/char|المحرف]] الذي يحدِّد نهاية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء المحدَّد [[Arduino/char|بالمحرف]] ذي الفهرس <code>from</code> وحتى نهاية [[Arduino/stringobject|السلسلة النصية]]. |
| − | فهرس [[Arduino/char|المحرف]] الذي يحدِّد نهاية الجزء المراد جلبه من [[Arduino/stringobject|السلسلة النصية]]. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، | ||
| − | |||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد [[Arduino/stringobject|السلسلة النصية الفرعية]] المحدَّدة بالمجال الواقع بين [[Arduino/char|المحرف]] ذي الفهرس <code>from</code> ونهاية السلسلة النصية أو [[Arduino/char|المحرف]] ذي الفهرس <code>to</code> (إن أعطي). | تعاد [[Arduino/stringobject|السلسلة النصية الفرعية]] المحدَّدة بالمجال الواقع بين [[Arduino/char|المحرف]] ذي الفهرس <code>from</code> ونهاية السلسلة النصية أو [[Arduino/char|المحرف]] ذي الفهرس <code>to</code> (إن أعطي). | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
| + | * التابع <code>[[Arduino/stringobject/charat|charAt()]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها. | ||
| + | * التابع <code>[[Arduino/stringobject/concat|concat()]]</code>: يضيف المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معه. | ||
| + | * التابع <code>[[Arduino/stringobject/getbytes|getBytes()]]</code>: يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن. | ||
| + | * التابع <code>[[Arduino/stringobject/replace|replace()]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه. | ||
| + | * التابع <code>[[Arduino/stringobject/setcharat|setCharAt()]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه. | ||
| + | |||
| + | * التابع <code>[[Arduino/stringobject/startswith|startsWith()]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه. | ||
| + | * التابع <code>[[Arduino/stringobject/trim|trim()]]</code>: يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه. | ||
| + | |||
==مصادر== | ==مصادر== | ||
| − | *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/substring/ صفحة | + | *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/substring/ صفحة التابع substring() في توثيق أردوينو الرسمي.] |
| + | [[تصنيف: Arduino]] | ||
| + | [[تصنيف: Arduino Method]] | ||
| + | [[تصنيف: Arduino String]] | ||
مراجعة 09:06، 30 أكتوبر 2018
يجلب التابع substring() جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه.
البنية العامة
string.substring(from)
string.substring(from, to)
تمثِّل string السلسلة النصية التي سيُجلَب منها الجزء المحدَّد بالمعامل from وحتى نهاية السلسلة أو حتى المعامل to إن أعطي.
المعاملات
from
فهرس المحرف الذي يحدِّد بداية الجزء المراد جلبه من السلسلة النصية. يدخل هذا المحرف ضمن المجال المعاد.
to
فهرس المحرف الذي يحدِّد نهاية الجزء المراد جلبه من السلسلة النصية. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء المحدَّد بالمحرف ذي الفهرس from وحتى نهاية السلسلة النصية.
القيم المعادة
تعاد السلسلة النصية الفرعية المحدَّدة بالمجال الواقع بين المحرف ذي الفهرس from ونهاية السلسلة النصية أو المحرف ذي الفهرس to (إن أعطي).
انظر أيضًا
- التابع
charAt(): يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها. - التابع
concat(): يضيف المعامل المُمرَّر إليها إلى السلسلة النصية التي استدعيت معه. - التابع
getBytes(): يجلب عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعه في مخزَّن معيَّن. - التابع
replace(): يبدِّل محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه. - التابع
setCharAt(): يعيِّن قيمة محرفٍ متوضِّع في السلسلة النصية التي استدعيت معه إلى المحرف المُمرَّر إليه.
- التابع
startsWith(): تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه. - التابع
trim(): يزيل جميع المسافات البيضاء من بداية ونهاية السلسلة النصية التي استدعيت معه.