الفرق بين المراجعتين لصفحة: «Arduino/stringobject/getbytes»

المراجعة الحالية بتاريخ 22:02، 6 نوفمبر 2018

يجلب التابع getBytes()‎ عددًا محدَّدًا من بايتات السلسلة النصية التي استدعيت معه ويضعها في مخزَّن معيَّن.

البنية العامة

string.getBytes(buf, len)

تمثِّل string السلسلة النصية التي يراد جلب البايتات len منها ووضعها في المعامل buf.

المعاملات

`buf`

مصفوفةُ من البايتات تُستعمَل كمخزنٍ تُنسَخ فيه المحارف.

`len`

عدد البايتات المراد نسخها من السلسلة النصية المعطاة ووضعها في المخزن buf.

القيم المعادة

لا يعاد أي شيء.

أمثلة

مثال على استعمال الدالة getBytes()‎:

String stringValue = "wiki Hsoub";
char buf[6];

void setup() {
   Serial.begin(9600);
}

void loop() {
  Serial.println(stringValue.indexOf("wiki")); // 5
  Serial.println(stringValue.indexOf("wiki", 7)); // 10
}

انظر أيضًا

التابع charAt()‎: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
التابع equals()‎: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
التابع indexOf()‎: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
التابع length()‎: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
التابع replace()‎: يبدِّل محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
التابع setCharAt()‎: يعيِّن قيمة محرفٍ متوضِّع في السلسلة النصية التي استدعيت معه إلى المحرف المُمرَّر إليه.

التابع startsWith()‎: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.

التابع substring()‎: يجلب جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه.

مصادر

صفحة التابع getBytes()‎ في توثيق أردوينو الرسمي.

@@ سطر 13: / سطر 13: @@
 ==القيم المعادة==
 لا يعاد أي شيء.
+==أمثلة==
+مثال على استعمال الدالة <code>getBytes()‎</code>:<syntaxhighlight lang="arduino">
+String stringValue = "wiki Hsoub";
+char buf[6];
+void setup() {
+   Serial.begin(9600);
+}
+void loop() {
+  Serial.println(stringValue.indexOf("wiki")); // 5
+  Serial.println(stringValue.indexOf("wiki", 7)); // 10
+}
+</syntaxhighlight>
 ==انظر أيضًا==
-* التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
+*التابع <code>[[Arduino/stringobject/charat|charAt()‎]]</code>: يجلب محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معها.
-* التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/equals|equals()‎]]</code>: يتحقَّق إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/indexof|indexOf()‎]]</code>: يعيد فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/length|length()‎]]</code>: يعيد عدد محارف السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/replace|replace()‎]]</code>: يبدِّل [[Arduino/char|محرفًا]] أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه.
-* التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
+*التابع <code>[[Arduino/stringobject/setcharat|setCharAt()‎]]</code>: يعيِّن قيمة [[Arduino/char|محرفٍ]] متوضِّع في [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه إلى [[Arduino/char|المحرف]] المُمرَّر إليه.
-* التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
-* التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
+*التابع <code>[[Arduino/stringobject/startswith|startsWith()‎]]</code>: تتحقَّق إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه.
+*التابع <code>[[Arduino/stringobject/substring|substring()‎]]</code>: يجلب جزءًا محدَّدًا من [[Arduino/stringobject|السلسلة النصية]] التي استدعيت معه.
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/variables/data-types/string/functions/getbytes/ صفحة التابع getBytes()‎ في توثيق أردوينو الرسمي.]