نتائج البحث

يجلب التابع charAt()‎ محرفًا ذا فهرس محدَّد من السلسلة النصية التي استدعيت معه. البنية العامة string.charAt(n) تمثِّل string السلسلة النصية المراد جلب محرف منها. المعاملات n عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس المحرف المراد جلبه من السلسلة النصية string المعطاة. القيم المعادة يعاد المحرف الواقع عند الفهرس n من السلسلة النصية string المعطاة. أمثلة مثال على استعمال الدالة charAt()‎: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { Serial.println(stringValue.charAt(1)); // i } انظر أيضًا التابع endsWith()‎: يتحقَّق إن ...

تُصفِّر الدالة bitClear()‎ قيمة بت محدَّد (أي تجعل قيمته 0) لمتغير عددي. البنية العامة bitClear(x, n) المعاملات x المتغير العددي المراد تصفير قيمة أحد بِتَّاته. n عدد يمثِّل فهرس البت المراد تصفيره؛ يأخذ البت الأقل أهمية (الواقع في أقصى اليمين) الفهرس 0. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال الدالة bitClear()‎: byte bits = 11000111; // 61 void setup() { Serial.begin(9600); } void loop() { Serial.println(bitRead(bits, 1)); // 1 bitClear(bits, 1); ...

تعيد الدالة micros()‎ زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميكروثانية. ستصل القيمة التي تحسبها هذه الدالة إلى حالة الطفحان (أي سيعود إلى الصفر) بعد مرور 70 دقيقة تقريبًا. في لوحات أردوينو التي تعمل بتردد 16 ميغاهرتز (مثل لوحات Duemilanove، و Nano)، تكون دقة هذه الدالة هي 4 ميكروثانية (أي القيمة التي تعيدها الدالة هي من مضاعفات العدد 4 دومًا). أمَّا في لوحات أردوينو التي تعمل بتردد 8 ميغاهرتز (مثل لوحات LilyPad)، تكون دقة هذه الدالة هي 8 ميكروثانية. البنية العامة ...

يحجز التابع reserve()‎ جزءًا من الذاكرة ويخصِّصه للتلاعب بالسلسلة النصية التي استدعيت معه وتعديلها. البنية العامة string.reserve(size) تمثِّل string السلسلة النصية التي سيُحجَز لها جزءٌ من الذاكرة بحجم size. المعاملات size عدد صحيح عديم الإشارة يحدِّد عدد البايتات المراد حجزها من الذاكرة وتخصيصها لعمليات التلاعب بالسلسلة النصية المعطاة والتعديل عليها. القيم المعادة لا يعاد أي شيء. أمثلة مثالٌ على استعمال التابع reserve()‎: String myString; void setup() { // تهيئة منفذ الاتصال التسلسلي وبدئه Serial.begin(9600); while (!Serial) { ...

تقرأ الدالة bitRead()‎ قيمة بت محدَّد لعدد. البنية العامة bitRead(x, n) المعاملات x العدد المراد قراءة قيمة أحد بِتَّاته. n عدد يمثِّل فهرس البت المراد قراءته؛ يأخذ البت الأقل أهمية (الواقع في أقصى اليمين) الفهرس 0. القيم المعادة تعاد قيمة البت n الواقع في العدد x، وتكون إمَّا 0 أو 1. أمثلة مثال على استعمال الدالة bitRead()‎: byte bits = 11000111; // 61 void setup() { Serial.begin(9600); } void loop() { Serial.println(bitRead(bits, 1)); // 1 bitClear(bits, 1); ...

يوفر المعامل [] إمكانية الوصول إلى محرف محدَّد من محارف السلسلة النصية المستعملة معه وإعادته. يشبه هذا المعامل التابع charAt()‎ تمامًا. البنية العامة char thisChar = string1[n] يُعرَّف المتغير thisChar المحرفي من أجل تخزين المحرف ذي الفهرس n من السلسلة النصية string1 فيه. المعاملات n عددٌ صحيح يمثِّل فهرس المحرف المراد جلبه من السلسلة النصية المعطاة. القيم المعادة يعاد المحرف ذو الفهرس n من السلسلة النصية المعطاة. أمثلة مثال على استعمال المعامل []: String stringValue = "wiki Hsoub"; char buf; void setup() { ...

يتحقَّق التابع startsWith()‎ إن كانت السلسلة النصية التي استدعيت معه تبدأ بالمحارف نفسها التي مُرِّرت إليه. البنية العامة string.startsWith(string2) تمثِّل string السلسلة النصية المراد التحقق من أنَّها تبدأ بمحارف المعامل string2. المعاملات string2 السلسلة النصية التي سيُتحقَّق من وجودها في بداية السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة النصية string المعطاة تبدأ بمحارف السلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال التابع startsWith()‎: String stringValue = "Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() ...

تستخرج الدالة highByte()‎ البايت العلوي (الواقع في أقصى اليسار) للكلمة المُمرَّرة إليها، أو البايت الثاني الذي يلي البايت السفلي الواقع في أقصى اليمين إن زاد حجم البيانات المُمرَّرة إليها عن حجم كلمة (2 بايت). البنية العامة highByte(x) المعاملات x أيُّ نوع من البيانات المراد استخراج البايت العلوي منها. القيم المعادة يعاد البايت العلوي (الواقع في أقصى اليسار) للبيانات x، أو البايت الثاني الذي يلي البايت السفلي الواقع في أقصى اليمين إن زاد حجم البيانات x عن حجم كلمة (2 بايت). ...

يحجز التابع reserve()‎ جزءًا من الذاكرة ويخصِّصه للتلاعب بالسلسلة النصية التي استدعيت معه وتعديلها. البنية العامة string.reserve(size) تمثِّل string السلسلة النصية التي سيُحجَز لها جزءٌ من الذاكرة بحجم size. المعاملات size عدد صحيح عديم الإشارة يحدِّد عدد البايتات المراد حجزها من الذاكرة وتخصيصها لعمليات التلاعب بالسلسلة النصية المعطاة والتعديل عليها. القيم المعادة لا يعاد أي شيء. أمثلة مثالٌ على استعمال التابع reserve()‎: String myString; void setup() { // تهيئة منفذ الاتصال التسلسلي وبدئه Serial.begin(9600); while (!Serial) { ...

تضبط الدالة bitSet()‎ قيمة بت محدَّد (أي تجعل قيمته 1) لمتغير عددي. البنية العامة bitSet(x, n) المعاملات x المتغير العددي المراد ضبط قيمة أحد بِتَّاته. n عدد يمثِّل فهرس البت المراد ضبطه؛ يأخذ البت الأقل أهمية (الواقع في أقصى اليمين) الفهرس 0. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال الدالة bitSet()‎: byte bits = 11000111; // 61 void setup() { Serial.begin(9600); } void loop() { Serial.println(bitRead(bits, 1)); // 1 bitClear(bits, 1); ...

تقرأ الدالة digitalRead()‎ قيمة أحد الأرجل الرقمية التي تكون إمَّا HIGH أو LOW. البنية العامة digitalRead(pin) المعاملات pin عددٌ يشير إلى الرجل الرقمية المراد قراءة قيمتها. القيم المعادة تعاد القيمة HIGH أو LOW التي تمثِّل قيمة الرجل pin الرقمية. أمثلة ضبط قيمة الرجل 13 إلى نفس قيمة الرجل 7 المعرَّفة على أنَّها رجل دخل: int ledPin = 13; // هنالك ضوء ليد متصل بالرجل 13 الرقمية int inPin = 7; // زر ضغط متصل بالرجل ...

يتحقَّق المعامل =! إن كانت السلسلة النصية التي تقع على يساره مختلفة عن السلسلة النصية التي تقع على يمينه. عملية التحقق من عدم التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق. سلوك هذا المعامل معاكس تمامًا لسلوك التابع equals()‎. البنية العامة string1 != string2 القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string1 غير مساوية للسلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال المعامل =!: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); while(!Serial) ...

يبدأ التابع begin()‎ عملية محاكاة (emulating) للوحة مفاتيح افتراضية موصولة بالحاسوب المتصل باللوحة Leonardo أو Due. إن أردت إنهاء هذه العملية، فاستدعِ التابع end()‎. البنية العامة Keyboard.begin() القيم المعادة لا يعاد أي شيء. أمثلة إرسال رسالة إلى الحاسوب عبر لوحة مفاتيح افتراضية متصلة به عند الضغط على زر موصول بالرجل 2: #include <Keyboard.h> void setup() { // جعل الرجل 2 رجل دخل مع تشغيل مقاومة الرفع // الداخلية عليها، لذا سيصبح جهدها مرتفع ما لم // توصل بخط ...

الإسناد بالتفكيك (destructuring assignment) يسمح باستخراج القيم الموجودة في المصفوفات أو خاصيات أحد الكائنات إلى متغيرات مستقلة. البنية العامة var a, b, rest; [a, b] = [10, 20]; console.log(a); // 10 console.log(b); // 20 [a, b, ...rest] = [10, 20, 30, 40, 50]; console.log(a); // 10 console.log(b); // 20 console.log(rest); // [30, 40, 50] ({ a, b } = { a: 10, b: 20 }); console.log(a); // 10 console.log(b); // 20 // Stage 3 proposal ({a, b, ...rest} = {a: 10, b: 20, c: 30, d: 40}); console.log(a); // 10 console.log(b); // 20 console.log(rest); //{c: ...

تقّدم الوحدة itertools مجموعة من الأدوات المُساعدة على بناء مُكرّرات مُشابهة لتلك المتوفّرة في لغات مثل APL، وHaskell وSML. بُني كلّ منها بطريقة تُناسب لغة بايثون. الأدوات المُتوفّرة سريعة وتستخدم الذّاكرة بشكل فعّال، وهي مُفيدة سواء بمُفردها أو عبر دمج بعضها ببعض. وعند دمجها مع بعض، تُشكّل "جبرَ مُكرّرات” تُعدّ وسيلة يُمكن استعمالها لإنشاء أدوات أكثر تخصّصًا بشكل فعّال باستخدام بايثون فقط دون الحاجة إلى أيّة لغة برمجيّة أخرى. تُوفّر لغة SML مثلًا الدّالة tabulate‎(f)‎ التي تُنتج السّلسلة ‎f(0)‎,‎ ‎f(1)‎,‎ ...

تعيد الدّالة map()‎ مُكرّرًا (iterator) يُطبّق الدّالة المُعطاة على كل عنصر من عناصر الكائن القابل للتّكرار المُعطى وتعاد نتيجة الاستدعاء في كلّ مرّة. البنية العامة map(function, iterable, ...) المعاملات function الدّالة المرغوب تطبيقها على كلّ عنصر من عناصر المُعامل iterable. iterable الكائن القابل للتّكرار المُراد استدعاء الدّالة function على كلّ عنصر من عناصره. يُمكن كذلك تمرير أكثر من كائن واحد قابل للتّكرار، وإن كان الأمر كذلك، فستُطبّق الدّالة على كلّ عنصر من عناصر الكائنات القابلة للتّكرار على التّوازي، وسيتوقّف المُكرّر ...

تعيد الدّالة itertools.zip_longest()‎ مُكرّرًا يُركّب العناصر من كلّ كائن من الكائنات القابلة للتّكرار المُعطاة. إن كانت الكائنات القابلة للتّكرار غير مُتساويّة في الطّول، فستُستخدم قيمة لملء الفراغات. يُكمل التّكرار إلى أن تنتهي قيم أطول كائن من الكائنات القابلة للتّكرار. البنية العامة itertools.zip_longest(*iterables, fillvalue=None) المعاملات iterables الكائنات القابلة للتّكرار المُراد تركيبها. fillvalue القيمة التي ستُملؤ بها الفراغات. إن لم تُعيّن قيمة للمُعامل فالقيمة الافتراضيّة تكون القيمةَ None. القيمة المعادة مُكرّر يُعيد صفوفًا تُركّب عناصرها من عناصر الكائنات القابلة للتّكرار المُعطاة، ويملؤ ...

يجلب التابع 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() ...

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها. البنية العامة string.remove(index) string.remove(index, count) تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط. المعاملات index عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها. count عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس ...

يبدِّل التابع replace()‎ محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه. البنية العامة string.replace(substring1, substring2) تمثِّل string السلسلة النصية التي يراد تبديل قيمة المعامل substring2 مكان قيمة المعامل substring1 أينما وجدت فيها. المعاملات substring1 القيمة التي يراد استبدال قيمة أخرى بها. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً فرعيةً. substring2 القيمة التي ستحل مكان قيمة المعامل substring1 أينما وُجدَت في السلسلة النصية المعطاة. القيم المعادة لا يعاد أي ...

تعيد الدالة millis()‎ زمن تشغيل لوحة أردوينو للبرنامج الحالي بالميلي ثانية. ستصل القيمة التي تحسبها هذه الدالة إلى حالة الطفحان (أي ستعود إلى الصفر) بعد مرور 50 يومٍ تقريبًا. البنية العامة time = millis() القيم المعادة يعاد عدد طويل عديم الإشارة (unsigned long) يمثِّل زمن بدء تشغيل لوحة أردوينو للبرنامج الحالي إلى لحظة استدعاء الدالة millis()‎ بالميلي ثانية. أمثلة استعمال الدالة millis()‎ لمعرفة منذ متى بدأت لوحة أردوينو بالعمل: unsigned long time; void setup(){ Serial.begin(9600); } void loop(){ Serial.print("Time: "); ...

يتحقَّق التابع endsWith()‎ إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه. البنية العامة string.endsWith(string2) المعاملات string السلسلة النصية المراد التحقق من أنَّها تنتهي بمحارف المعامل string2. string2 السلسلة النصية التي سيُتحقَّق من وجودها في نهاية السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة النصية string تنتهي بمحارف السلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال الدالة endsWith()‎: String stringValue = "We love wikiHsoub"; void setup() { Serial.begin(9600); } void ...

يبدِّل التابع replace()‎ محرفًا أو سلسلةً نصيةً فرعيةً مكان محرف أو سلسلة نصية فرعية محدَّدة موجودة في السلسلة النصية التي استدعيت معه. البنية العامة string.replace(substring1, substring2) تمثِّل string السلسلة النصية التي يراد تبديل قيمة المعامل substring2 مكان قيمة المعامل substring1 أينما وجدت فيها. المعاملات substring1 القيمة التي يراد استبدال قيمة أخرى بها. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً فرعيةً. substring2 القيمة التي ستحل مكان قيمة المعامل substring1 أينما وُجدَت في السلسلة النصية المعطاة. القيم المعادة لا يعاد أي ...

يجلب التابع 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() ...

يتحقَّق التابع equals()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق. البنية العامة string.equals(string2) المعاملات string السلسلة النصية الأولى المراد التحقق من تساويها مع السلسلة string2. string2 السلسلة النصية الثانية المراد التحقُّق من تساويها مع السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string مساويةً للسلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال ...

يتحقَّق المعامل == من تساوي سلسلتين نصيَّتين مع بعضهما بعضًا. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق. سلوك هذا المعامل مماثل تمامًا لسلوك التابع equals()‎. البنية العامة string1 == string2 القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string1 مساويةً للسلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال المعامل ==: String stringValue = "wiki Hsoub"; void setup() { Serial.begin(9600); while(!Serial) ; Serial.println(stringValue ...

يتحقَّق التابع equalsIgnoreCase()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه مع عدم أخذ حالة الأحرف بالحسبان. هذا يعني أنَّ عملية التحقق من التساوي غير حساسة لحالة الأحرف، لذا تكون السلسلة "hello" مساويةً للسلسلة "HELLO". البنية العامة string.equalsIgnoreCase(string2) المعاملات string السلسلة النصية الأولى المراد التحقق من تساويها مع السلسلة string2. string2 السلسلة النصية الثانية المراد التحقُّق من تساويها مع السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string مساويةً للسلسلة string2، أو ...

يحذف التابع remove()‎ عددًا محدَّدًا من محارف السلسلة النصية التي استدعيت معها. انتبه إلى أنَّ هذه الدالة تعدِّل نفس السلسلة النصية المعطاة، لذا كن حذرًا عند استعمالها. البنية العامة string.remove(index) string.remove(index, count) تمثِّل string السلسلة النصية التي يراد حذف محارفها التي تبدأ عند المحرف ذي الفهرس index وحتى نهاية السلسلة أو بعدد المحارف count فقط. المعاملات index عددٌ صحيحٌ عديم الإشارة يمثِّل فهرس بداية المحارف المراد حذفها. count عددٌ صحيحٌ عديم الإشارة يمثِّل عدد العناصر المراد حذفها بدءًا من المحرف ذي الفهرس ...

يتحقَّق المعامل < إن كانت السلسلة النصية التي تقع على يساره أكبر تمامًا من السلسلة النصية التي تقع على يمينه. يُجرِي هذا المعامل عملية الموازنة بناءً على الترتيب الأبجدي للمحارف المتقابلة من السلسلتين النصيتين. أي يكون 'b' > 'a' و '1' < '2' محقَّقين ولكن "999" < "1000" غير محقَّقٍ لأنَّ المحرف '9' يأتي بعد المحرف '1' عند إجراء الموازنة بين أول محرفين. تنبيه: يمكن أن تكون معاملات موازنة السلاسل النصية محيِّرة بعض الشيء خصوصًا عند استعمالها في موازنة السلاسل ...

يتحقَّق التابع endsWith()‎ إن كانت السلسلة النصية التي استدعيت معه تنتهي بالمحارف نفسها التي مُرِّرت إليه. البنية العامة string.endsWith(string2) المعاملات string السلسلة النصية المراد التحقق من أنَّها تنتهي بمحارف المعامل string2. string2 السلسلة النصية التي سيُتحقَّق من وجودها في نهاية السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة النصية string تنتهي بمحارف السلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استعمال الدالة endsWith()‎: String stringValue = "We love wikiHsoub"; void setup() { Serial.begin(9600); } void ...

يتحقَّق التابع equalsIgnoreCase()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه مع عدم أخذ حالة الأحرف بالحسبان. هذا يعني أنَّ عملية التحقق من التساوي غير حساسة لحالة الأحرف، لذا تكون السلسلة "hello" مساويةً للسلسلة "HELLO". البنية العامة string.equalsIgnoreCase(string2) المعاملات string السلسلة النصية الأولى المراد التحقق من تساويها مع السلسلة string2. string2 السلسلة النصية الثانية المراد التحقُّق من تساويها مع السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string مساويةً للسلسلة string2، أو ...

يرسل التابع click()‎ ضغطة سريعة وخاطفة إلى الحاسوب عند موقع مؤشر الفأرة الحالي. يشبه سلوك هذا التابع الضغط بسرعةٍ على زر الفأرة ضغطةً واحدةً. الزر الافتراضي الذي يضغطه هذا التابع هو زر الفأرة الأيسر. البنية العامة Mouse.click(); Mouse.click(button); المعاملات button محرفٌ يحدِّد هذا المعامل زر الفأرة المراد ضغطه. القيم التي يمكن استعمالها مع هذا المعامل هي: MOUSE_LEFT (القيمة الافتراضية) MOUSE_RIGHT MOUSE_MIDDLE القيم المعادة لا يعاد أي شيء. أمثلة الضغط على زر الفأرة الأيسر في موقع المؤشر الحالي عند الضغط على الزر ...

تكتب الدالة bitWrite()‎ قيمة معينَّة على أحد بتات العدد المُمرَّر إليها. البنية العامة bitWrite(x, n, b) المعاملات x العدد المراد كتابة قيمة معيَّنة على أحد بِتَّاته. n عدد يمثِّل فهرس البت المراد تغيير قيمته؛ يأخذ البت الأقل أهمية (الواقع في أقصى اليمين) الفهرس 0. b القيمة المراد كتابتها على البت n وتكون إمَّا 0 أو 1. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال الدالة bitWrite()‎: byte bits = 11000111; ...

يتحقَّق التابع equals()‎ إن كانت السلسلة النصية التي استدعيت معه مساويةً للسلسلة النصية التي مُرِّرت إليه. عملية التحقق من التساوي حساسة لحالة الأحرف؛ هذا يعني أنَّ السلسلة "hello" لا تساوي "Hello" على الإطلاق. البنية العامة string.equals(string2) المعاملات string السلسلة النصية الأولى المراد التحقق من تساويها مع السلسلة string2. string2 السلسلة النصية الثانية المراد التحقُّق من تساويها مع السلسلة string. القيم المعادة تعاد القيمة true المنطقية إن كانت السلسلة string مساويةً للسلسلة string2، أو تعاد القيمة false خلاف ذلك. أمثلة مثال ...

تهيِّئ الدالة pinMode()‎ رجل معيَّنة لتسلك إمَّا سلوك دخل (input) أو سلوك خرج (output). اطلع على «الدرس التعليمي حول الأرجل الرقمية» لمزيدٍ من المعلومات حول وظائف الأرجل. بدءًا من الإصدار أردوينو 1.0.1، أصبح بالإمكان تفعيل مقاومة الرفع الداخلية عبر استعمال الوضع INPUT_PULLUP. أضف إلى ذلك أنَّ الوضع INPUT يعطِّل مقاومات الرفع الداخلية تلقائيًّا. البنية العامة pinMode(pin, mode) المعاملات pin عددٌ يشير إلى الرجل الرقمية المراد تهيئتها إلى الوضع mode. mode الوضع الذي يحدِّد سلوك الرجل pin ويكون إمَّا INPUT أو ...

تعيد الدّالة sum()‎ مجموع عناصر الكائن القابل للتكرار المُعطى إضافةً إلى قيمة بدئيّة إن مُرِّرَت. البنية العامة sum(iterable[, start]) المعاملات iterable الكائن القابل للتّكرار المرغوب جمع عناصره التي تكون عادةً قيمًا عدديّة. start مُعامل اختياريّ يُمثّل القيمة البدئيّة التي ستُضاف إلى المجموع في بدايته، قيمته الافتراضيّةُ 0، ولا يجوز أن تكون قيمته سلسلةً نصيّة. القيمة المعادة مجموع عناصر الكائن القابل للتّكرار إضافةً إلى القيمة البدئيّة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> sum([1, 2, 3]) # مجموع قائمة ...

يعيد التابع كائن تكرار iterator يتضمّن أرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. البنية العامة ‎iterweekdays() القيمة المعادة يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. وتكون القيمة الأولى في كائن التكرار هي نفسها قيمة الخاصية firstweekday. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.iterweekdays(): ... print(c) ... 0 1 2 3 4 5 6 انظر أيضًا التابع itermonthdates()‎: يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. التابع ...

تجمع الدالة union()‎ العناصر المشتركة وغير المتشركة بين المصفوفة أو المجموعة التكرارية التي استُدعيت معها وبين المجموعة التكرارية المُمرّرة إليها في مجموعةٍ واحدةٍ من النوع Set بعد حذف العناصر المتكررة. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. تضاف عناصر المجموعة التكرارية الممرَّرة إلى الدالة وغير المتكررة في النهاية. البنية العامة يمكن استدعاء الدالةunion()‎ مع المصفوفات والمجموعات التكرارية: infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T> infix fun ByteArray.union(other: Iterable<Byte>): Set<Byte> infix fun ShortArray.union( ...

يعيد التابع lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. تبحث الدالة ابتداءً من نهاية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية. البنية العامة string.lastIndexOf(val) string.lastIndexOf(val, from) تمثِّل string السلسلة النصية التي سيُبحَث ضمنها عن قيمة المعامل val. المعاملات val القيمة التي يراد البحث عنها وإعادة فهرس آخر ظهور لها ضمن السلسلة النصية المعطاة. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً. from فهرس المحرف الذي يراد ...

تهيِّئ الدالة randomSeed()‎ البذرة التي يستعملها مولد الأعداد الشبه عشوائية (pseudo-random numbers) في عملية التوليد. استعمال قيم مختلفة للبذرة يؤدي إلى بدء المولد عملية توليد سلسلة الأعداد العشوائية عند نقطة اعتباطية. رغم أنَّ هذه السلسلة المولَّدة طويلة جدًا وعشوائيَّة إلا أنَّها ثابتة (أي تبقى نفسها ولا تتغير). إن كان من المهم أن تختلف سلسلة من القيم المولدة باستعمال الدالة random()‎ عن بعضها بعضًا في التنفيذ اللاحق للشيفرة، فاستعمل الدالة randomSeed()‎ لتهيئة مولد العدد العشوائي مع تمرير قيمة مدخلة عشوائية تمامًا ...

يتحقَّق التابع isPressed()‎ إن كان زر معيَّن من أزرار الفأرة مضغوطًا أم لا. البنية العامة Mouse.isPressed(); Mouse.isPressed(button); المعاملات button محرفٌ يحدِّد هذا المعامل زر الفأرة المراد التحقُّق منه. القيم التي يمكن استعمالها مع هذا المعامل هي: MOUSE_LEFT (القيمة الافتراضية) MOUSE_RIGHT MOUSE_MIDDLE القيم المعادة تعاد القيمة true المنطقية إن كان الزر button (أو الزر الأيسر إن لم يُعطَ) مضغوطًا أم لا. أمثلة استعمال قاطعتين لضغط زر الفأرة الأيسر باستمرار وتحريره: #include <Mouse.h> void setup(){ // قاطعة تستعمل من أجل الضغط على زر ...

يكتب التابع write()‎ بيانات ثنائية على منفذ الاتصال التسلسلي. تُرسَل هذه البيانات كبايت أو سلسلة من البايتات. إن أردت إرسال محارف تمثِّل أرقام عددٍ، فاستعمل التابع print()‎ عوضًا ذلك. البنية العامة Serial.write(val) Serial.write(str) Serial.write(buf, len) // أيضًا Serial3, Serial2, Serial1 استعمال المنافذ Mega تدعم لوحات أردوينو المعاملات val قيمةٌ يراد إرسالها على أنَّها بايتٌ مفردٌ. str سلسلةٌ نصيةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. buf مصفوفةٌ يراد إرسالها بشكل سلسلة من البايتات المفردة. القيم المعادة يعاد عدد البايتات التي كُتبَت على المنفذ التسلسلي. ...

يضيف التابع concat()‎ المعامل المُمرَّر إليه إلى السلسلة النصية التي استدعيت معه. البنية العامة string.concat(parameter) تمثِّل string السلسلة النصية المراد إضافة قيمة المعامل parameter إليها. المعاملات parameter القيمة المراد إضافتها إلى السلسلة النصية المعطاة. أنواع البيانات المسموح بها هي: الكائن String، وسلسلة نصية، ومحرف، وبايت، وعدد صحيح، وعدد صحيح عديم الإشارة، وعدد طويل، وعدد طويل عديم الإشارة، وعدد عشري، وعدد عشري مضاعف، و ‎__FlashStringHelper(F() macro)‎. القيم المعادة تعاد القيمة true المنطقية إن نجحت العملية، أو القيمة false إن فشلت العملية ولم ...

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ الأعداد العشرية تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل ...

يحرِّر التابع releaseAll()‎ جميع المفاتيح التي ضُغِط عليها مسبقًا باستعمال التابع press()‎. البنية العامة Keyboard.releaseAll() القيم المعادة لا يعاد أي شيء. أمثلة استعمال لوحة المفاتيح الافتراضية لإنشاء مستند جديد في الحاسوب المتصل باللوحة: #include <Keyboard.h> // OS X استعمل هذا الخيار من أجل أنظمة char ctrlKey = KEY_LEFT_GUI; // أو استعمال هذا الخيار من أجل أنظمة ويندوز ولينكس // char ctrlKey = KEY_LEFT_CTRL; void setup() { // جعل الرجل 2 رجل دخل مع تشغيل مقاومة الرفع // الداخلية، لذا سيصبح جهد الرجل ...

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ الأعداد العشرية تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل ...

يجمع (يدمج) المعامل + سلسلتين نصيتين مع بعضهما بعضًا في سلسلة نصية واحدة جديدو ثمَّ يعيدها. تضاف السلسلة النصية الثانية التي تلي المعامل إلى السلسلة النصية الأولى ثم تعاد سلسلة نصية جديدة تحوي الناتج. وظيفة هذا المعامل مماثلة تمامًا للتابع concat()‎. البنية العامة string3 = string1 + string2; string3 += string2; في الحالة الأولى، تُضاف السلسلة النصية string2 إلى السلسلة النصية string1 ثم يُخزَّن الناتج في السلسلة النصية string3. يمكن استعمال المعامل =+ المركب في الحالة الثانية لإضافة السلسلة string2 إلى السلسلة ...

يتحقَّق المعامل > إن كانت السلسلة النصية التي تقع على يساره أصغر من السلسلة النصية التي تقع على يمينه. يُجرِي هذا المعامل عملية الموازنة بناءً على الترتيب الأبجدي للمحارف المتقابلة من السلسلتين النصيتين. أي يكون 'b' > 'a' و '1' < '2' محقَّقين ولكن "999" < "1000" غير محقَّق لأنَّ المحرف '1' يأتي قبل المحرف '9' (أي أصغر منه) عند إجراء الموازنة بين أول محرفين. تنبيه: يمكن أن تكون معاملات موازنة السلاسل النصية محيِّرة بعض الشيء خصوصًا عند استعمالها في ...

يتحقَّق المعامل =< إن كانت السلسلة النصية التي تقع على يساره أكبر من أو تساوي السلسلة النصية التي تقع على يمينه. يُجرِي هذا المعامل عملية الموازنة بناءً على الترتيب الأبجدي للمحارف المتقابلة من السلسلتين النصيتين. أي يكون 'b' > 'a' و '1' < '2' محقَّقين ولكن "999" < "1000" غير محقَّق لأنَّ المحرف '9' يأتي بعد المحرف '1' (أي أكبر منه) عند إجراء الموازنة بين أول محرفين. تنبيه: يمكن أن تكون معاملات موازنة السلاسل النصية محيِّرة بعض الشيء خصوصًا عند ...

يعيد التابع indexOf()‎ فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. يبحث التابع ابتداءً من بداية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية. البنية العامة string.indexOf(val) string.indexOf(val, from) تمثِّل string السلسلة النصية التي سيُبحَث ضمنها عن قيمة المعامل val. المعاملات val القيمة التي يراد البحث عنها وإعادة فهرس أول ظهور لها ضمن السلسلة النصية المعطاة. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً. from فهرس المحرف الذي يراد ...

يحرِّر التابع release()‎ زر الفأرة الذي ضُغِط عليه مسبقًا باستعمال التابع press()‎. البنية العامة Mouse.release(); Mouse.release(button); المعاملات button محرفٌ يحدِّد هذا المعامل زر الفأرة المراد تحريره. القيم التي يمكن استعمالها مع هذا المعامل هي: MOUSE_LEFT (القيمة الافتراضية) MOUSE_RIGHT MOUSE_MIDDLE القيم المعادة يعاد عدد المفاتيح المُحرَّرة. أمثلة استعمال قاطعتين لضغط زر الفأرة الأيسر باستمرار وتحريره في موقع المؤشر الحالي: #include <Mouse.h> void setup(){ // قاطعة تستعمل من أجل الضغط على زر الفأرة pinMode(2,INPUT); // قاطعة أخرى تستعمل من أجل تحرير ...

يعيد التابع indexOf()‎ فهرس أول ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. يبحث التابع ابتداءً من بداية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية. البنية العامة string.indexOf(val) string.indexOf(val, from) تمثِّل string السلسلة النصية التي سيُبحَث ضمنها عن قيمة المعامل val. المعاملات val القيمة التي يراد البحث عنها وإعادة فهرس أول ظهور لها ضمن السلسلة النصية المعطاة. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً. from فهرس المحرف الذي يراد ...

يضيف التابع concat()‎ المعامل المُمرَّر إليه إلى السلسلة النصية التي استدعيت معه. البنية العامة string.concat(parameter) تمثِّل string السلسلة النصية المراد إضافة قيمة المعامل parameter إليها. المعاملات parameter القيمة المراد إضافتها إلى السلسلة النصية المعطاة. أنواع البيانات المسموح بها هي: الكائن String، وسلسلة نصية، ومحرف، وبايت، وعدد صحيح، وعدد صحيح عديم الإشارة، وعدد طويل، وعدد طويل عديم الإشارة، وعدد عشري، وعدد عشري مضاعف، و ‎__FlashStringHelper(F() macro)‎. القيم المعادة تعاد القيمة true المنطقية إن نجحت العملية، أو القيمة false إن فشلت العملية ولم ...

يعيد التابع lastIndexOf()‎ فهرس آخر ظهور لمحرف أو سلسلة نصية معيَّنة ضمن السلسلة النصية التي استدعيت معه. تبحث الدالة ابتداءً من نهاية السلسلة النصية المعطاة افتراضيًّا، ولكن يمكن بدء البحث من أي موضع ضمن السلسلة النصية. البنية العامة string.lastIndexOf(val) string.lastIndexOf(val, from) تمثِّل string السلسلة النصية التي سيُبحَث ضمنها عن قيمة المعامل val. المعاملات val القيمة التي يراد البحث عنها وإعادة فهرس آخر ظهور لها ضمن السلسلة النصية المعطاة. يمكن أن يكون هذا المعامل محرفًا أو سلسلةً نصيةً. from فهرس المحرف الذي يراد ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة أعداد صحيحة. البنية العامة itermonthdays(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تعاد الأيام على هيئة أعداد تمثّل اليوم في الشهر، أما الأيام التي تكون خارج الشهر المحدد فتأخذ القيمة 0. أمثلة يبين المثال التالي ...

 الكلمات المفتاحيّة الثابتة (Hard Keywords) تُعدُّ الكلمات الآتية كلماتٍ مفتاحيّةً في لغة Kotlin وليس ممكنًا استخدامها كمُعرِّفات (identifiers): as تُستخدَم في التحويلات ما بين الأنواع (typecasts) تُحدِّد تسميةً بديلةً (alias) عند عملية الاستيراد (import) as?‎ للتحويلات الحافظة للنوع (safe type casts) break لإنهاء تنفيذ الحلقات (loops) class للتصريح عن الأصناف continue  للاستمرار بالخطوة التالية لأقرب حلقة محيطة (enclosing) do للبدء بحلقة do/while (والتي يُختبَر الشرط فيها لاحقًا) else لتعريف فرعٍ (branch) من تعبير الشرط if والذي سيُنفَّذ عندما يكون الشرط بالقيمة false false ...

تعيد الدّالة itertools.cycle()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتّكرار المُعطى ويحفظ نسخة منه، عندما تنتهي قيم الكائن القابل للتّكرار، يُعيد المُكرّر عناصر النّسخة المحفوظة، ويُكرّر ذلك مرارًا وتكرارًا دون نهاية. البنية العامة itertools.cycle(iterable) المعاملات iterable الكائن القابل للتّكرار المرغوب الدّوران على قيمه بشكل لا نهائيّ. القيمة المعادة مُكرّر يُعيد قيم الكائن المُعطى مرارًا وتكرارًا. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ استعمال الدّالة next‎()‎ للوصول إلى القيمة المواليّة في المُكرّر، وهذا لأنّ المُكرّر النّاتج لا متناهٍ، وتحويله إلى ...

‎.each( function )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يكرر هذا التابع، عبر كائن jQuery، تنفيذ دالة لكل عنصر متطابق. ‎.each( function )‎ أُضيف مع الإصدار: 1.0. function دالة تُنفَّذ لكل عنصر متطابق، وهي على الشكل Function( Integer index, Element element )‎. صُمِم التابع ‎.each()‎ لجعل بنية حلقات المرور على عناصر DOM موجزة وأقل عُرضةً للخطأ. عند استدعائه فإنه سيمر على جميع عناصر DOM التي تشكل جزءًا من كائن jQuery. في كل مرة تُشغل فيها دالة رد نداء، ...

abs()‎ القيمة المطلقة (absolute value) لعدد معيّن. all()‎ القيمة True إن كانت جميع عناصر الكائن القابل للتكرار (iterable) المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. any()‎ القيمة True إن كان أحد عناصر الكائن القابل للتكرار (iterable) المعطى يساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ascii()‎ تمثيل (representation) نصي لكائن مُعيّنٍ يُمكن طباعته. bin()‎ تُحوّل عددًا صحيحًا (integer number) إلى سلسلةٍ نصيّةٍ ثنائيّة (binary string) مسبوقة بالمقطع النّصيّ "0b". bool()‎ قيمة منطقيّة تكون إمّا ...

تعيد الدّالة min()‎ أصغر عنصر من عناصر كائن قابل للتّكرار أو أصغر مُعامل من مُعاملين أو أكثر. البنية العامة min(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل min(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أضغر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

تعيد الدّالة max()‎ أكبر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر. البنية العامة max(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل max(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أكبر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): BooleanIterator وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال التابع iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع جميع العناصر: fun main(args: Array<String>) { ...

يُستعمَل العنصر <audio> لتضمين المحتوى الصوتي في المستندات، وقد يحتوي على ملف مصدري واحد أو أكثر التي تُمثَّل باستخدام الخاصية src أو عبر العنصر <source>، وسيختار المتصفح أنسب الملفات الصوتية لتشغيلها. المثال الآتي يستخدم العنصر <audio> مع الخاصية autoplay لتشغيل الصوت تلقائيًا مع تحديد رابط URL للملف المصدري عبر الخاصية src: <audio src="khamsat.mp3" autoplay> لا يدعم متصفحك العنصر <code>audio</code>. </audio> أما المثال الآتي ففيه العنصر <audio> مع استخدام خاصية controls لإضافة أزرار للتحكم بالمقطع، وسيُحدَّد رابط URL للمقطع عبر العنصر <source>: ...

تعيد الدّالة itertools.starmap()‎ مُكرّرًا يستدعي الدّالة باستخدام المُعاملات المُعطاة في الكائن القابل للتّكرار. تُستعمل عوضًا عن الدالة map()‎ عندما تكون قيم المُعاملات مُجموعةً في صفّ في كائن واحد قابل للتّكرار (أي أنّ البيانات قد جُمِّعَت مُسبقًا). الفرق بين الدالة map()‎ والدّالة itertools.starmap()‎ يُوازي الفرق بين الاستدعاء function(a,b)‎‎ والاستدعاء function(*c)‎‎. البنية العامة itertools.starmap(function, iterable) المعاملات function الدّالة المُراد استدعاؤها. iterable كائن قابل للتّكرار يحتوي على صفوف لتُمرّر إلى الدّالة كمُعاملات مُفكّكة. القيمة المعادة مُكرّر يُعيد نتائج استدعاء الدّالة واحدة بواحدة. أمثلة ...

يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة. البنية العامة ‎array.extend(iterable) المعاملات iterable كائن التكرار المراد إضافة عناصره إلى نهاية المصفوفة. إن كان كائن التكرار المعطى هو مصفوفة أخرى، فيجب حينئذ أن تحمل رمز النوع نفسه، وإلا تطلق اللغة الخطأ TypeError. أما إن لم يكن كائن التكرار المعطى مصفوفةً، فيجب أن يكون كائن تكرار يتضمن عناصر يمكن إضافتها إلى المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> ls = [6, ...

تعيد الدّالة itertools.product()‎ حاصل الضرب الديكارتي (أو الضرب المباشر) للكائنات القابلة للتّكرار المُعطاة. طريقة العمل مُكافئة لحلقات for المُتداخلة في تعبير مُولّد. مثلًا، الاستدعاء product(A, B)‎ يُعيد ما يُعيده التّعبير ‎((x,y)‎ for‎ x‎ in A‎ for y in B‎)‎. تدور الحلقات المُتداخلة مثل عدّاد مسافة (odometer) من العنصر على أقصى اليمين مُتقدّمةً عند كلّ تكرار. يُنشئ هذا النّسق ترتيبًا مُعجميًّا (lexicographic)، لذا فإن كانت الكائنات القابلة للتّكرار المُعطاة مُرتّبةً، فستُنتج صفوف الضّرب المُباشر مُرتّبةً. البنية العامة itertools.product(*iterables, repeat=1) المعاملات iterables ...

يوازن التابع compareTo()‎ بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. يجري التابع عملية الموازنة على كل محرفين متقابلين من السلسلتين النصيتين المراد الموازنة بينهما بناءً على قيمة هذين المحرفين في الجدول ASCII. هذا يعني أنَّ الحرف 'a' مثلًا أصغر من المحرف 'b' (يأتي قبله) ولكنَّه أكبر من المحرف 'A' (يأتي بعده)؛ الأرقام أصغر من الحروف الأبجدية دومًا. البنية العامة string.compareTo(string2) المعاملات string السلسلة النصية الأولى المراد موازنتها. string2 السلسلة النصية الثانية المراد موازنتها مع المعامل ...

يجلب التابع substring()‎ جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه. البنية العامة string.substring(from) string.substring(from, to) تمثِّل string السلسلة النصية التي سيُجلَب منها الجزء المحدَّد بالمعامل from وحتى نهاية السلسلة أو حتى المعامل to إن أعطي. المعاملات from فهرس المحرف الذي يحدِّد بداية الجزء المراد جلبه من السلسلة النصية. يدخل هذا المحرف ضمن المجال المعاد. to فهرس المحرف الذي يحدِّد نهاية الجزء المراد جلبه من السلسلة النصية. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء ...

يحرِّر التابع release()‎ مفتاحًا محدَّدًا ضُغِط عليه مسبقًا باستعمال التابع press()‎. البنية العامة Keyboard.release(key) المعاملات key المفتاح المراد تحريره من عملية الضغط المستمرة. القيم المعادة يعاد عدد المفاتيح المُحرَّرة. أمثلة استعمال لوحة المفاتيح الافتراضية لإنشاء مستند جديد في الحاسوب: #include <Keyboard.h> // OS X استعمل هذا الخيار من أجل أنظمة char ctrlKey = KEY_LEFT_GUI; // أو استعمال هذا الخيار من أجل أنظمة ويندوز ولينكس // char ctrlKey = KEY_LEFT_CTRL; void setup() { // جعل الرجل 2 رجل دخل مع تشغيل مقاومة الرفع ...

يرسل التابع press()‎ ضغطة مستمرة إلى الحاسوب عند موقع مؤشر الفأرة الحالي. يشبه سلوك هذه التابع الضغط باستمرار على زر الفأرة. يُحرَّر زر الفأرة المضغوط عليه عبر استدعاء التابع release()‎. قبل استعمال التابع press()‎، يجب استدعاء التابع begin()‎. البنية العامة Mouse.press(); Mouse.press(button) المعاملات button محرفٌ يحدِّد هذا المعامل زر الفأرة المراد ضغطه باستمرار. القيم التي يمكن استعمالها مع هذا المعامل هي: MOUSE_LEFT (القيمة الافتراضية) MOUSE_RIGHT MOUSE_MIDDLE القيم المعادة لا يعاد أي شيء. أمثلة استعمال قاطعتين لضغط زر الفأرة الأيسر باستمرار وتحريره ...

يوازن التابع compareTo()‎ بين سلسلتين نصيتين ويحدِّد أيهما أكبر من الأخرى أو إن كانتا متساويتين. يجري التابع عملية الموازنة على كل محرفين متقابلين من السلسلتين النصيتين المراد الموازنة بينهما بناءً على قيمة هذين المحرفين في الجدول ASCII. هذا يعني أنَّ الحرف 'a' مثلًا أصغر من المحرف 'b' (يأتي قبله) ولكنَّه أكبر من المحرف 'A' (يأتي بعده)؛ الأرقام أصغر من الحروف الأبجدية دومًا. البنية العامة string.compareTo(string2) المعاملات string السلسلة النصية الأولى المراد موازنتها. string2 السلسلة النصية الثانية المراد موازنتها مع المعامل ...

يتحقَّق التابع if(Serial)‎ إن كان المنفذ Serial التسلسلي المُمرَّر إليه جاهزًا للاستعمال. في لوحات أردوينو Leonardo، يتحقَّ التابع if(Serial)‎ إن كان منفذ الاتصال USB CDC مفتوحًا أم لا. في جميع النسخ الأخرى (من ضمنها if(Serial1)‎) في لوحات Leonardo، ذلك الاستدعاء سيعيد دومًا القيمة true. عُرِّف هذا التابع في الإصدار أردوينو 1.0.1. البنية العامة // جميع اللوحات if (Serial) // Leonardo لوحات أردوينو if (Serial1) // Mega لوحات أردوينو if (Serial1) if (Serial2) if (Serial3) القيم المعادة تعاد القيمة true المنطقية إن كان منفذ الاتصال التسلسلي المحدَّد متاحًا. ...

يجلب التابع substring()‎ جزءًا محدَّدًا من السلسلة النصية التي استدعيت معه. البنية العامة string.substring(from) string.substring(from, to) تمثِّل string السلسلة النصية التي سيُجلَب منها الجزء المحدَّد بالمعامل from وحتى نهاية السلسلة أو حتى المعامل to إن أعطي. المعاملات from فهرس المحرف الذي يحدِّد بداية الجزء المراد جلبه من السلسلة النصية. يدخل هذا المحرف ضمن المجال المعاد. to فهرس المحرف الذي يحدِّد نهاية الجزء المراد جلبه من السلسلة النصية. لا يدخل هذا المعامل ضمن المجال المعاد. هذا المعامل اختياري؛ إن لم يُعطَ، سيُعاد الجزء ...

يقرأ التابع read()‎ البيانات المستلمة عبر الاتصال التسلسلي. يرث التابع read()‎ من الصنف Stream. البنية العامة Serial.read() // فقط Mega لوحات أردوينو Serial1.read() Serial2.read() Serial3.read() القيم المعادة يعاد البايت الأول من البيانات المتاحة الآتية من منفذ الاتصال التسلسلي المحدَّد، أو تعاد القيمة 1- إن لم يكن هنالك أية بيانات متاحة للقراءة. أمثلة قراءة البيانات المستلمة من منفذ الاتصال التسلسلي وإعادة إرسالها: int incomingByte = 0; // متغير لتخزين البيانات المراد قراءتها void setup() { Serial.begin(9600); ...

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): DoubleIterator وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) { val f: (Int) -> ...

ينشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): FloatIterator وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) { val f: (Int) -> ...

ينشئ التابع iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): ByteIterator وجود الكلمة المفتاحية operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال التابع iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع جميع العناصر: import java.util.Arrays fun main(args: Array<String>) { val f: (Int) -> ...

تُطبّق الدّالة functools.reduce()‎ دالّة تأخذ مُعاملين بتراكب لعناصر الكائن القابل للتّكرار المُعطى، من اليسار إلى اليمين لتخفيض العناصر إلى قيمة واحدة (كجمع عدّة مبالغ للحصول على مبلغ إجماليّ واحد مثلًا). البنية العامة functools.reduce(function, iterable[, initializer]) المعاملات function الدّالة المُراد تطبيقها على عناصر الكائن القابل للتّكرار. iterable الكائن القابل للتّكرار. initializer قيمة بدئيّة تُضاف إلى بداية العناصر قبل بدء الحساب، وتكون كذلك قيمة افتراضيّة عندما يكون الكائن القابل للتّكرار فارغًا. إن لم تُمرّر قيمة للمُعامل initializer واحتوى الكائن القابل للتّكرار على ...

تنشئ الدالة iterator()‎ عنصرًا تكراريًّا (iterator) لتكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة المستدعاة معه. البنية العامة operator fun iterator(): CharIterator وجود الكلمة المفتاحية operator يدل على أنّ هذه الدالة مرتبطٌة بمعامل تكرار (iteration operator، اطلع على المثال في الأسفل). القيم المعادة يعاد عنصرٌ تكراريٌٌ (iterator) من أجل تكرار بنيةٍ (block) برمجيةٍ معينة على كافّة عناصر المصفوفة المعطاة. أمثلة استعمال الدالة iterator()‎ لتخصيص عنصر تكراري من أجل استخدامه في الحلقة for التكرارية التي تطبع قيم جميع العناصر: fun main(args: Array<String>) { val f: (Int) -> ...

تحول الدالة toMutableSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع MutableSet؛ تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية. البنية العامة يمكن استدعاء الدالة toMutableSet()‎ مع المصفوفات والمجموعات التكرارية: fun <T> Array<out T>.toMutableSet(): MutableSet<T> fun ByteArray.toMutableSet(): MutableSet<Byte> fun ShortArray.toMutableSet(): MutableSet<Short> fun IntArray.toMutableSet(): MutableSet<Int> fun LongArray.toMutableSet(): MutableSet<Long> fun FloatArray.toMutableSet(): MutableSet<Float> fun DoubleArray.toMutableSet(): MutableSet<Double> fun BooleanArray.toMutableSet(): MutableSet<Boolean> fun CharArray.toMutableSet(): MutableSet<Char> fun <T> Iterable<T>.toMutableSet(): MutableSet<T> القيمة المعادة تعاد مجموعة من النوع MutableSet تحوي جميع عناصر ...

تحول الدالة toSet()‎ المصفوفة أو المجموعة التكرارية التي استُدعيت معها إلى مجموعة من النوع Set. تحافظ المجموعة المُعادة على نفس ترتيب تكرار المصفوفة أو المجموعة التكرارية الأصلية.  البنية العامة يمكن استدعاء الدالة toSet()‎ مع المصفوفات والمجموعات التكرارية: fun <T> Array<out T>.toSet(): Set<T> fun ByteArray.toSet(): Set<Byte> fun ShortArray.toSet(): Set<Short> fun IntArray.toSet(): Set<Int> fun LongArray.toSet(): Set<Long> fun FloatArray.toSet(): Set<Float> fun DoubleArray.toSet(): Set<Double> fun BooleanArray.toSet(): Set<Boolean> fun CharArray.toSet(): Set<Char> fun <T> Iterable<T>.toSet(): Set<T> القيمة المعادة تعاد مجموعة من النوع Set تحوي جميع عناصر المصفوفة أو المجموعة التكرارية المعطاة. أمثلة استعمال الدالة ()toSet لتحويل مصفوفة إلى مجموعة من ...

تعيد الدّالة itertools.islice()‎ مُكرّرًا يُعيد عناصر مُنتقاة من الكائن القابل للتّكرار المُعطى. تُنتقى العناصر بتقطيع الكائن القابل للتّكرار حسب المُعاملات المُعطاة للدّالة. البنية العامة itertools.islice(iterable, stop) itertools.islice(iterable, start, stop[, step]) المعاملات iterable الكائن القابل للتّكرار المرغوب تقطيع عناصره. start مُعامل اختياريّ يُمثّل نقطة البداية، إن كانت قيمتها لا تُساوي الصّفر، فستُتجاهل عناصر الكائن iterable إلى حين الوصول إلى العنصر الذي يُوافق فهرسه (index) قيمة start. stop مُعامل يُحدّد نقطة التّوقف، إن كانت قيمتُه القيمةَ None فسيستمرّ التّكرار إلى حين انتهاء قيم ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. البنية العامة itermonthdays2(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تكون الأيام المعادة على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. ...

تعيد الدّالة zip()‎ مُكرّرًا يُركّب عناصر كلّ من الكائنات القابلة للتّكرار المُعطاة. البنية العامة zip(*iterables) المعاملات iterables مُعامل اختياريّ يُمثّل الكائنات القابلة للتّكرار المرغوب تركيبها. القيمة المعادة مُكرّر يحتوي على صفوف تكون عناصرها ذات نفس الفهرس (index) في كلّ عنصر من عناصر الكائنات القابلة للتّكرار. إذ يحتوي مثلا أول صفّ على جميع العناصر التي تكون أول العناصر في الكائنات القابلة للتّكرار المُعطاة (انظر الأمثلة أدناه). يتوقّف المُكرّر عندما تنتهي عناصر أصغر كائن قابل للتّكرار. عند استدعائها بكائن واحد قابل للتّكرار ...

تجلب الدالة takeLast()‎ آخر n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة.  البنية العامة fun <T> Array<out T>.takeLast(n: Int): List<T> fun ByteArray.takeLast(n: Int): List<Byte> fun ShortArray.takeLast(n: Int): List<Short> fun IntArray.takeLast(n: Int): List<Int> fun LongArray.takeLast(n: Int): List<Long> fun FloatArray.takeLast(n: Int): List<Float> fun DoubleArray.takeLast(n: Int): List<Double> fun BooleanArray.takeLast(n: Int): List<Boolean> fun CharArray.takeLast(n: Int): List<Char> fun <T> List<T>.takeLast(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر الأخيرة المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل أكبر من طول المصفوفة أو المجموعة التكرارية، فستعاد ...

تعيد الدّالة itertools.repeat()‎ مُكرّرًا يُعيد كائنًا مرارًا وتكرارًا بشكل لا نهائي أو لعدد مُحدّد من المرّات. تُستخدم مع الدالة map()‎ لاستدعاء دالّة عدّة مرّات بنفس المُعاملات. وتُستخدم كذلك مع الدالة zip()‎ لإنشاء جزء لا يتغيّر في كلّ صفّ. البنية العامة itertools.repeat(object[, times]) المعاملات object الكائن المُراد تكراره. times مُعامل اختياريّ يُحدّد عدد مرّات التّكرار، يكون التّكرار لا نهائيًّا إن لم تُمرّر له أيّة قيمة. القيمة المعادة مُكرّر يُعيد الكائنَ بشكل لا نهائيّ أو لعدد مُحدّد من المرّات حسب ما مُرِّرَ ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. البنية العامة itermonthdates(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year، وسيعيد هذا الكائن جميع الأيام (ككائنات datetime.date) للأشهر والأيام كلها قبل بداية الشهر أو بعد نهاية الشهر والتي تكون مطلوبة للحصول على أسبوع كامل. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.itermonthdates(2018, 8): ... ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. البنية العامة itermonthdays3(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. كون الأيام المعادة على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. ملاحظة: هذا التابع جديد في الإصدار ...

تعيد الدّالة itertools.chain()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. البنية العامة itertools.chain(*iterables) المعاملات iterables الكائنات القابلة للتّكرار المرغوب تحويلها إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المُعطاة حسب التّرتيب التي مُرّرت فيها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> c = itertools.chain([1, 2, 3], 'abc') >>> c <itertools.chain ...

(PHP 4, PHP 5, PHP 7) تحصي الدالة array_count_values()‎ عدد مرات تكرار كل قيمة موجودة داخل المصفوفة. الوصف array array_count_values ( array $array ) تنشئ الدالة array_count_values()‎ مصفوفةً جديدةً تحتوي على القيم الموجودة بالمصفوفة المُمَرََرة بالمعامل array كمفاتيح، وعدد مرات تكرار كل قيمة في هذه المصفوفة كقيم مرتبطة بتلك المفاتيح. المعاملات array مصفوفة تحتوي على قيم تحصي هذه الدالة عدد مرات تكرار كل واحدة منها. القيم المعادة تعيد الدالة مصفوفة جديدة من القيم الموجودة بالمصفوفة المُمَرََرة، ويرتبط مع كل قيمة ...

(PHP 4, PHP 5, PHP 7) تحصي الدالة array_count_values()‎ عدد مرات تكرار كل قيمة موجودة داخل المصفوفة. الوصف array array_count_values ( array $array ) تنشئ الدالة array_count_values()‎ مصفوفةً جديدةً تحتوي على القيم الموجودة بالمصفوفة المُمَرََرة بالمعامل array كمفاتيح، وعدد مرات تكرار كل قيمة في هذه المصفوفة كقيم مرتبطة بتلك المفاتيح. المعاملات array مصفوفة تحتوي على قيم تحصي هذه الدالة عدد مرات تكرار كل واحدة منها. القيم المعادة تعيد الدالة مصفوفة جديدة من القيم الموجودة بالمصفوفة المُمَرََرة، ويرتبط مع كل قيمة ...

تجلب الدالة take()‎ أول n عنصر من المصفوفة أو المجموعة التكرارية التي استُدعيت معها وتضعها في قائمة. البنية العامة fun <T> Array<out T>.take(n: Int): List<T> fun ByteArray.take(n: Int): List<Byte> fun ShortArray.take(n: Int): List<Short> fun IntArray.take(n: Int): List<Int> fun LongArray.take(n: Int): List<Long> fun FloatArray.take(n: Int): List<Float> fun DoubleArray.take(n: Int): List<Double> fun BooleanArray.take(n: Int): List<Boolean> fun CharArray.take(n: Int): List<Char> fun <T> Iterable<T>.take(n: Int): List<T> المعاملات n عدد صحيح يمثل عدد العناصر الأولى المراد جلبها من المصفوفة أو المجموعة التكرارية المعطاة. إن كانت القيمة المعطاة لهذا المعامل ...

تعيد الدّالة itertools.chain.from_iterable()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. وتُعدّ الدّالة طريقة بديلة للدّالة itertools.chain()‎، إذ تستقبل هذه الأخيرة عدّة مُعاملات عوضًا عن مُعامل واحد فقط. البنية العامة itertools.chain.from_iterable(iterable) المعاملات iterable الكائن القابل للتّكرار المرغوب تحويل الكائنات التي بداخله إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المتواجدة في ...

تعيد الدّالة itertools.tee()‎ عددًا مُحدّدًا من المُكرّرات المُستقلّة عن بعضها البعض من كائن واحد قابل للتّكرار. البنية العامة itertools.tee(iterable, n=2) المعاملات iterable الكائن القابل للتّكرار. n عدد المُكرّرات المُستقلّة المرغوب إنشاؤها من الكائن iterable. القيمة المعادة عددٌ n من المُكرّرات المُستقلّة المُولَّدة من الكائن القابل للتّكرار المُعطى. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> it = itertools.tee('abc', 2) >>> it (<itertools._tee object at 0x7f79c6fc9f48>, <itertools._tee object at 0x7f79c4e73588>) >>> [list(i) for i in it] [['a', 'b', 'c'], ['a', 'b', 'c']] ملاحظات الدّالة ...

تسمح الدالة iterator()‎ بالتكرار (iterate) على كائنٍ ديناميكيّ (dynamic) في الحالات الآتية: إن كان لديه دالة تكراريّة (iterator function). إن كان مصفوفةً (array). إن كان نسخةً (instance) من Kotlin.collections.Iterable. البنية العامة operator fun dynamic.iterator(): Iterator<dynamic> بيئة التشغيل المطلوبة: JS. ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator). انظر أيضًا الدالة ()asDynamic: تعيد قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكيّ (dynamic type). مصادر صفحة الدالة iterator()‎ في التوثيق الرسميّ للمكتبة القياسيّة ...

تسمح الدالة iterator()‎ بالتكرار (iterate) على كائنٍ ديناميكيّ (dynamic) في الحالات الآتية: إن كان لديه دالة تكراريّة (iterator function). إن كان مصفوفةً (array). إن كان نسخةً (instance) من Kotlin.collections.Iterable. البنية العامة operator fun dynamic.iterator(): Iterator<dynamic> بيئة التشغيل المطلوبة: JS. ويُلاحظ وجود الكلمة المفتاحيّة operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator). انظر أيضًا الدالة ()asDynamic: تعيد قيمة الكائن الذي استدعيت عبره على شكل قيمةٍ من النوع الديناميكيّ (dynamic type). مصادر صفحة الدالة iterator()‎ في التوثيق الرسميّ للمكتبة القياسيّة ...

تعرِض هذه الصفحة عددًا من التعابير الاصطلاحيّة المستخدَمة بكثرةٍ في لغة Kotlin، ولأيّ اصطلاحٍ جديدٍ لم يُذكَر فيمكنك تعديل هذه الصفحة لإضافته. إنشاء كائنات نقل البيانات DTO:‏ Data Transfer Objects (الكائنات POJO/POCO) ليكن الصنف (class) الآتي باسم Customer: data class Customer(val name: String, val email: String) وله التوابع الوظيفيّة (functional methods) الآتية: توابع getter (وتوابع setter في حالة المتحولات من النوع var) لكافة الخاصّيّات (properties) equals()‎ hashCode()‎ toString()‎ copy()‎ component1()‎ و component2()‎ ...إلخ. وذلك لكافة الخاصّيّات (properties) في الصنف (راجع أصناف البيانات ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nlargest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nsmallest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

تعيد الدالة Array.iterator()‎ عنصرًا تكراريًّا (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. البنية العامة operator fun iterator(): Iterator<T> ويُلاحظ وجود الكلمة المفتاحية operator للدلالة على أنّ هذه الدالة مرتبطٌ بمعامل التكرار (iteration operator) المستخدم في شيفرة المثال اللاحق. القيم المعادة يعاد عنصرٌ تكراريٌّ (iterator) بهدف تكرار بنيةٍ (block) برمجيةٍ على كافّة عناصر المصفوفة. أمثلة تنشِئ الشيفرة الآتية مصفوفةً من ستة أعدادٍ صحيحةٍ بالاعتماد على الدالة arrayOf ثم تخصِّص لهذه المصفوفة عنصرًا تكراريًا (iterator) باستخدام الدالة iterator()‎ لاستخدامه في ...