نتائج البحث

يمثل الصنف Range مجالًا (مجموعة) من القيم لها بداية ونهاية. يمكن إنشاء المجالات باستخدام الصياغة الحرفية بالشكل s..e و s...e ، أو باستخدام التابع الباني new. المجالات المُنشأة باستخدام الصياغة .. تشمل عنصري البداية والنهاية. أما تلك المُنشأة باستخدام الصياغة ... فلن تشمل قيمة النهاية. عند استخدامها كمكرر (iterator)، ستعيد المجالات كل قيمها بالتتابع. (-1..-5).to_a #=> [] (-5..-1).to_a #=> [-5, -4, -3, -2, -1] ('a'..'e').to_a #=> ["a", "b", "c", ...

عناصر <input> ذات النوع range تسمح للمستخدم بتحديد قيمة عددية ليست أقل من قيمة معيّنة وليست أكبر من قيمة أخرى، ولا تعتبر القيمة الدقيقة لمدخلات المستخدم مهمةً. يُمثَّل هذا العنصر عادةً باستخدام مزلاج عوضًا عن حقل نصي (الذي يُمثِّل الحقل number)، ولأنَّ هذا الحقل لا يوفِّر تحكمًا دقيقًا فستكون القيمة الدقيقة التي أدخلها المستخدم غير مهمة. إذا لم يكن المتصفح يدعم الحقل range فسيستخدم المتصفح الحقل text الافتراضي. <input type="range" name="range"> الخاصية value تحتوي الخاصية value في الحقل range على سلسلة نصية (DOMString) التي ...

الصنف الزائف ‎:in-range في CSS (أي pseudo-class) يُمثِّل أيّة عناصر <input> التي تكون قيمتها ضمن المجال المسموح المُحدَّد عبر الخاصيتين min و max. input:in-range { background-color: rgba(0, 255, 0, 0.25); } هذا المُحدِّد مفيد لإعطاء المستخدم دلالةً بصريةً على أنَّ القيمة الحالية للحقل ضمن الحدود المسموحة. لاحظ أنَّ هذا الصنف الزائف يُطبَّق على العناصر التي يمكن أن نُحدِّد مجال القيم التي تقبلها. الشكل العام لهذا المحدد: :in-range أمثلة مثال عن استخدام الصنف الزائف ‎:in-range والصنف الزائف ‎:out-of-range لإعطاء دلالة بصرية على ...

الصنف الزائف ‎:out-of-range في CSS (أي pseudo-class) يُمثِّل أيّة عناصر <input> التي لا تكون قيمتها ضمن المجال المسموح المُحدَّد عبر الخاصيتين min و max. input:out-of-range { background-color: rgba(255, 0, 0, 0.25); } هذا المُحدِّد مفيد لإعطاء المستخدم دلالةً بصريةً على أنَّ القيمة الحالية للحقل خارج الحدود المسموحة. لاحظ أنَّ هذا الصنف الزائف يُطبَّق على العناصر التي يمكن أن نُحدِّد مجال القيم التي تقبلها. الشكل العام لهذا المحدد: :out-of-range أمثلة مثال عن استخدام الصنف الزائف ‎:out-of-range والصنف الزائف ‎:in-range لإعطاء دلالة بصرية ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة range()‎‎‎‎‎‎‎‎‎‎ مصفوفةً تحتوي على مجال من العناصر. الوصف array range ( mixed $start , mixed $end [, number $step = 1 ] تنشئ هذه الدالة مصفوفةً تحتوي على مجال (range) من العناصر. المعاملات start أول قيمة في المجال أو محرف البداية. end ينتهي المجال عند الوصول إلى القيمة end أو محرف النهاية. step إذا ضُبِطَت قيمةٌ للمعامل step، فستُستخدم كمقدار لزيادة العناصر في المجال. ويجب أن تكون قيمة step موجبة. وإذا لم تُحدد ...

تعيد الدّالة range()‎ كائن مجال يحتوي على أعداد صحيحة من نقطة البداية إلى نقطة النّهاية مع فصلها بمسافة عدديّة. البنية العامة range(stop) range(start, stop[, step]) المعاملات start نقطة بداية المجال. stop نقطة نهاية المجال. step المسافة العدديّة التي ستكون بين عناصر المجال. القيمة المعادة كائن مجال يُعدّ نوعًا من أنواع التّسلسلات غير القابلة للتّغيير (immutable sequence type). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> list(range(3)) # من صفر إلى ثلاثة [0, 1, 2] >>> list(range(1, 5)) # من 1 إلى 5 [1, ...

يتحقق المعامل == من تساوي مجالين مع بعضهما بعضًا. يكون مجالان متساويين إن كان كل منهما من النوع Range وكان لهما نفس عنصري البداية والنهاية (بمقارنتهما بالمعامل ==)، وكان لهما أيضًا نفس الضبط exclude_end?‎. البنية العامة rng == obj → true or false‎ القيمة المعاد تعاد القيمة true إن كان الكائن obj من النوع Range ومساويًا للمجال rng. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع ==‎: (0..2) == (0..2) ...

يعيد المعامل === القيمة true إن كانت قيمةٌ أو كائنٌ ما أحد عناصر المجال (أي تقع ضمنه). المعامل === هو معامل المقارنة الذي تستخدمه عبارات case. البنية العامة rng === obj → true or false‎ ‎القيمة المعادة تعاد القيمة true إن كان الكائن obj أحد عناصر المجال rng (أي يقعع ضمنه)، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ===‎: case 79 when 1..50 then print "low\n" when 51..75 then print "medium\n" when ...

استخدام المجالات تُصاغُ تعابير المجالات (range expressions) من خلال دوال rangeTo التي تعتمد على المعامل .. والذي بدوره يتُمَّم بالمعاملين inو ‎!in، إذ من الممكن أن يُعرَّف المجال لأيّ نوعٍ يقبل المقارنة، أما في حالة الأنواع الأساسيّة المتكاملة (integral primitive types) فلها تعريف استخدام مُحسَّن (optimized)، وهذه بعض الأمثلة: if (i in 1..10) { // مكافئ للصياغة // 1 <= i && i ...

يضبط التابع fill قيم عناصر محدَّدة أو جميع عناصر مصفوفة إلى القيمة الممرَّرة إليه (الأشكال الثلاث الأولى للتابع في قسم «البنية العامة»)، أو القيم التي تعيدها الكتلة البرمجية الممرَّرة إليه (الأشكال الثلاث المتبقية). البنية العامة fill(obj) → ary fill(obj, start [, length]) → ary fill(obj, range ) → ary fill { |index| block } → ary fill(start [, length] ) { |index| block } → ary fill(range) { |index| block } → ary المعاملات obj الكائن المراد أن يحل مكان عناصر محددة (باستعمال المعاملات ...

يتحقق التابع eql?‎ من تساوي مجالين مع بعضهما بعضًا. يكون مجالان متساويين إن كان كل منهما من النوع Range وكان لهما نفس عنصري البداية والنهاية (بمقارنتها بواسطة المعامل eql?‎) ، وكان لهما أيضًا نفس الضبط exclude_end?‎ لقيمة النهاية. البنية العامة eql?(obj) → true or false‎ المعاملات obj‎ ‎المجال المراد التحقق من تساويه مع المجال المعطى. القيمة المعادة تعاد القيمة true إن كان الكائن obj من النوع Range ومساويًا للمجال rng. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع eql?‎: ...

يقتطع التابع slice!‎ عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من المصفوفة التي استدعيت معه. يعيد التابع slice!‎ العناصر المحذوفة، أو nil إن كان index خارج النطاق. البنية العامة slice!(index) → obj or nil slice!(start, length) → new_ary or nil slice!(range) → new_ary or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. start عدد صحيح يمثل فهرس البداية للعناصر المراد اقتطاعها من المصفوفة المعطاة. length عدد صحيح يمثل طول العناصر ...

يجلب التابع byteslice محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. ترميز السلسلة النصية المُعادة يكون من نفس ترميز السلاسل الأصلية. البنية العامة byteslice(integer) → new_str or nil byteslice(integer, integer) → new_str or nil byteslice(range) → new_str or nil المعاملات index عدد صحيح يمثل فهرس المحرف المراد جلبه من السلسلة المعطاة. ...

يجلب التابع slice عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة ‎-1 فهرس العنصر الأخير. ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة slice(index) → obj or nil slice(start, length) → new_ary or nil slice(range) → new_ary or nil المعاملات index عدد صحيح يمثل فهرس العنصر المراد اقتطاعه من المصفوفة المعطاة. ...

يكرر التابع step تنفيذ الكتلة المعطاة ويمرر إليها n عنصرًا من عناصر المجال بالتتابع. إن كان عنصرا البداية والنهاية عددين، فسيضاف n عند كل تكرار. وإلا، فإن التابع step سيستدعي succ للتكرار على عناصر المجال. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلاً من ذلك. البنية العامة step(n=1) {| obj | block } → rng step(n=1)→ an_enumerator‎ المعاملات n‎ عدد صحيح يمثِّل الخطوة. الخطوة الافتراضية هي: 1. القيمة المعادة يعاد مجالٌ، أو كائن من الصنف Enumerator في حال ...

يجلب المعامل [] عنصرًا ذي فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من مصفوفة. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين start و range، يكون فهرس البداية قبل العنصر. إضافةً إلى ذلك، ستُعاد مصفوفة فارغة في حال كان فهرس بداية المجال المحدد يقع عند نهاية المصفوفة. البنية العامة ary[index] → obj or nil ary[start, length] → new_ary or nil ary[range] → new_ary ...

يقتطع التابع !slice محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة. عند تمرير تعبير نمطي (Regexp) إلى التابع slice، يعيد التابع الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط ...

يجلب التابع slice محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة. عند تمرير تعبير نمطي (Regexp) إلى التابع slice، يعيد التابع الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط ...

يبدِّل المعامل [] عند استدعائه بالشكل ‎[]=‎‎ سلسلةً نصيةً محدَّدةً مكان جزءٍ محدَّد أو كامل محتوى سلسلة نصية أخرى. البنية العامة str[integer] = new_str str[integer, integer] = new_str str[range] = aString str[regexp] = new_str str[regexp, integer] = new_str str[regexp, name] = new_str str[other_str] = new_str يحدَّد الجزء المراد تبديله من السلسلة النصية str بالطريقة نفسها المذكورة في المعامل []. إن كان طول السلسلة النصية المعطاة لا يطابق طول السلسلة النصية (أو الجزء المحدّد) المراد تبديله، فستُعدَّل السلسلة النصية المعطاة تلك وفقًا لذلك. إن كان التعبير النمطي أو ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

يعيّن المعامل [] قيمة عنصر ذي فهرس محدد، أو قيم عدة عناصر تبدأ عند عنصر محدد وتمتد عددًا محددًا من العناصر، أو قيم عدة عناصر موجودة عند مجال محدد في مصفوفة. إن كانت الفهارس تشير إلى عناصر تقع خارج نطاق المصفوفة المعطاة، فستُوسَّع المصفوفة تلقائيًا. تُدرج العناصر في المصفوفة عند الفهرس start إن كانت قيمة الوسيط length تساوي 0. إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع العنصر بدءًا من نهاية المصفوفة، إذ تمثِّل القيمة ‎-1 فهرس العنصر الأخير. بالنسبة للوسيطين ...

يعيد التابع caller_locations مكدس التنفيذ (execution stack) الحالي كمصفوفة تحتوي كائنات تعقب عكسي (backtrace location objects). انظر صفحة Thread::Backtrace::Location لمزيد من المعلومات. البنية العامة caller_locations(start=1, length=nil) → array or nil caller_locations(range)→ array or nil‎ يحدد الوسيط الاختياري start عدد مدخلات المكدس الأولية التي ستُحذف من أعلى المكدس. ويمكن استخدام الوسيط length اختياري ثاني لتحديد عدد المدخلات التي ستُعاد من المكدس. يعيد التابع القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي. اختياريًا، يمكنك تمرير مجال range، والذي سيؤدي إلى ...

يولد التابع rand عددًا شبه عشوائي يقع ضمن مجال محدَّد. البنية العامة rand(max=0) → number‎ إن استدعي التابع rand بدون تمرير معاملات إليه، أو إن كان max.to_i.abs == 0، فسيعيد التابع rand عددًا عشريًا شبه عشوائي (pseudo-random) محصورًا في المجال 0.0 و 1.0 (يدخل 0.0 ضمن المجال بينما لا يدخل 1.0). إذا كان max.abs أكبر من أو يساوي 1، فسيعيد rand عددًا صحيحًا عشوائيًا أكبر من أو يساوي 0، وأصغر من max.to_i.abs. إذا كان المعامل المعطى مجالًا (من النوع Range)، فسيعيد ...

يجلب المعامل [] محرفًا ذا فهرس محدد، أو جزءًا محددًا ببداية وطول، أو مجالًا محددًا ببداية ونهاية من السلسلة النصية التي استدعيت معه. في الحالات الثلاث السابقة، إن مُرِّرت قيم سالبة للفهارس، فسيُحسَب موضع المحرف بدءًا من نهاية السلسلة، إذ تمثل القيمة ‎-1 فهرس المحرف الأخير. بالنسبة للحالتين الثانية والثالثة، فهرس البداية يُحسب قبل محرف واحد والفهرس يطابق حجم السلسلة. عند تمرير تعبير نمطي (Regexp) إلى المعامل []، يعيد الجزء المطابق من السلسلة. إذا أُلحق التعبير النمطي بمُعامل التقاط (capture)، ...

يُنشئ التّابع Document.createRange()‎ كائنًا جديدًا من النّوع Range. البنية العامة range = document.createRange(); range كائنٌ جديدٌ من النّوع Range. أمثلة var range = document.createRange(); range.setStart(startNode, startOffset); range.setEnd(endNode, endOffset); ملاحظات بعد إنشاء الكائن Range، ستحتاج إلى ضبط نقاط الحدود الخاصّة به قبل التّمكّن من استعمال مُعظم توابعه. مصادر ومواصفات مواصفة DOM Level 2 Range: DocumentRange.createRange

يعيد التابع caller مكدس التنفيذ الحالي (execution stack)، والذي هو مصفوفة تحتوي على سلاسل نصية بالشكل file:line أو `file:line: in `method. البنية العامة caller(start=1, length=nil) → array or nil caller(range) → array or nil‎ يحدد الوسيط الاختياري start عدد مدخالات المكدس الأولية (initial stack entries) التي ستٌحذف من الجزء العلوي من المكدس. يمكن استخدام وسيط اختياري ثاني length لتحديد عدد المدخلات التي ستُعاد من المكدس. يعيد التابع caller القيمة nil إن كان الوسيط start أكبر من حجم مكدس التنفيذ الحالي. اختياريًا، ...

تختلف عبارة for قليلًا في بايثون عن نظيرتها في لغتي C أو Pascal، فبدلًا من تكرار الحلقة استنادًا إلى عملية حسابية (مثل لغة Pascal) أو منح المستخدم القدرة على تعريف عدد مرات التكرار والشرط الذي يؤدي إلى إيقاف عمل الحلقة (كما في لغة C)، فإنّ عبارة for في بايثون تمرّ على عناصر أي تسلسل (قائمة أو سلسلة نصية) معتمدة في ذلك على ترتيب تلك العناصر في ذلك التسلسل. بنية عبارة for >>> # معرفة أطوال السلاسل النصية: ... words = ['cat', ...

تختلف عبارة for قليلًا في بايثون عن نظيرتها في لغتي C أو Pascal، فبدلًا من تكرار الحلقة استنادًا إلى عملية حسابية (مثل لغة Pascal) أو منح المستخدم القدرة على تعريف عدد مرات التكرار والشرط الذي يؤدي إلى إيقاف عمل الحلقة (كما في لغة C)، فإنّ عبارة for في بايثون تمرّ على عناصر أي تسلسل (قائمة أو سلسلة نصية) معتمدة في ذلك على ترتيب تلك العناصر في ذلك التسلسل. بنية عبارة for >>> # معرفة أطوال السلاسل النصية: ... words = ['cat', ...

يُعيد التابع rand عددًا عشوائيًّا يتراوح مجاله بحسب القيمة المُمرَّرة إليه. البنية العامة rand → float rand(max) → number المعاملات max يكون المعامل max إما عددًا صحيحًا (integer)، أو عددًا عشريًّا (float)، أو مجالًا (range). القيم المعادة عندما يكون المعامل maxعددًا صحيحًا، يُعيد التابع rand عددًا صحيحًا أكبر أو يساوي الصفر وأصغر من max. خلافًا للتابع Kernel.rand، يرمي التابع rand الاستثناء ArgumentError عندما يكون المعامل maxعددًا صحيحًا سالبًاأو صفرًا. عندما يكون المعامل maxعددًا عشريًّا، يعيد التابع randعددًا ذو فاصلة عشرية (floating ...

يعدُّ التابع rand:: اسمًا بديلًا (alias) للتابع Random::DEFAULT.rand. البنية العامة rand → float rand(max) → number المعاملات max يكون المعامل max إما عددًا صحيحًا (integer)، أو عددًا عشريًّا (float)، أو مجالًا (range). القيم المعادة عندما يكون المعامل max عددًا صحيحًا، يُعيد التابع rand عددًا صحيحًا أكبر أو يساوي الصفر وأصغر من max. خلافًا للتابع Kernel.rand، يرمي التابع randالاستثناء ArgumentError عندما يكون المعامل maxعددًا صحيحًا سلبيًّا أو صفرًا. عندما يكون المعامل maxعددًا عشريًّا، يعيد التابع randعددًا ذو فاصلة عائمة (floating point) عشوائيًّا ...

تنشئ الدالة MatchGroup()‎ البانية كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. البنية العامة MatchGroup(actual value: String, range: IntRange) منصة التشغيل المطلوبة: JVM. MatchGroup(actual value: String) منصة التشغيل المطلوبة: JS. المعاملات value قيمة مجموعة النتائج التي تم الحصول عليها. range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. الخاصية range متوافرة على منصة JVM فقط. القيم المعادة يعاد كائن من النوع MatchGroup. أمثلة في الشيفرة الآتية  نعرّف كائنًا من ...

تنشئ الدالة MatchGroup()‎ البانية كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. البنية العامة MatchGroup(actual value: String, range: IntRange) منصة التشغيل المطلوبة: JVM. MatchGroup(actual value: String) منصة التشغيل المطلوبة: JS. المعاملات value قيمة مجموعة النتائج التي تم الحصول عليها. range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. الخاصية range متوافرة على منصة JVM فقط. القيم المعادة يعاد كائن من النوع MatchGroup. أمثلة في الشيفرة الآتية  نعرّف كائنًا من ...

تحذف الدالة removeRange()‎ مجالًا محددًا من سلسلة المحارف أو السلسلة النصية التي استٌدعيت معها. البنية العامة fun CharSequence.removeRange( startIndex: Int, endIndex: Int ): CharSequence inline fun String.removeRange( startIndex: Int, endIndex: Int ): String fun CharSequence.removeRange(range: IntRange): CharSequence inline fun String.removeRange(range: IntRange): String المعاملات startIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد حذفه. endIndex عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد حذفه (لا ...

ملاحظة قبل البدء: تختلف هذه التقنية عن تقنية تغليف الحقول (Encapsulate Field) من حيث أنّها تُستخدَم لتغليف الحقول الخاصّة (أي المُحدَّدة بالكلمة المفتاحيّة private). المشكلة الوصول المباشر إلى الحقول الخاصّة (private fields) داخل الصنف (class). الحل إنشاء تابعي الوصول getter و setter للحقل الخاصّ ومنع الوصول إليه إلا عبرهما. مثال قبل إعادة التصميم يحتوي الصنف Range على الحقلين low و high من النوع الخاص (private) ونلاحظ الوصول إليهما مباشرةً داخل التابع includes في الشيفرة الآتية: في لغة Java: class Range ...

تعيد الدّالة itertools.combinations()‎ تسلسلات فرعيّة (subsequences) تُعدّ تجميعاتٍ ذات طولٍ مُحدّد لعناصر الكائن القابل للتّكرار المُعطى. تُنتَج التّجميعات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فلن تُكرّر أيّة قيم في كلّ تجميعة. البنية العامة itertools.combinations(iterable, r) المعاملات iterable الكائن القابل للتّكرار. r طول الصّفوف النّاتجة. القيمة المعادة صفوف بالطول المُعطى ...

تقدّم المولِّدات (Generators) طريقة سهلة لاستخدام المكرِّرات (Iterators) البسيطة دون الدخول في تعقيدات استخدام صنف يطبّق الواجهة Iterator. تتيح المولِّدات كتابة شيفرة تستخدم foreach لمرور على مجموعة من البيانات دون الحاجة إلى بناء مصفوفة في الذاكرة مما قد يؤدي إلى تجاوز حدود الذاكرة، أو يحتاج إلى وقت معالجة طويل لإنشائه. بدلًا من ذلك، يمكن كتابة دالة مولِّدة وهي دالة مشابهة للدوال الاعتيادية باستثناء أنّها لا تعيد النتيجة مرة واحدة بل تعيد العدد المطلوب من النتائج لغرض تقديم القيم التي يتم ...

تقدّم المولِّدات (Generators) طريقة سهلة لاستخدام المكرِّرات (Iterators) البسيطة دون الدخول في تعقيدات استخدام صنف يطبّق الواجهة Iterator. تتيح المولِّدات كتابة شيفرة تستخدم foreach لمرور على مجموعة من البيانات دون الحاجة إلى بناء مصفوفة في الذاكرة مما قد يؤدي إلى تجاوز حدود الذاكرة، أو يحتاج إلى وقت معالجة طويل لإنشائه. بدلًا من ذلك، يمكن كتابة دالة مولِّدة وهي دالة مشابهة للدوال الاعتيادية باستثناء أنّها لا تعيد النتيجة مرة واحدة بل تعيد العدد المطلوب من النتائج لغرض تقديم القيم التي يتم ...

تتصرف الكائنات MatchData بشكل مشابه للمصفوفات، إذ يمكن الوصول إليها باستخدام تقنيات فهرسة المصفوفات العادية. التعبير mtch[0]‎ مكافئ للمتغير الخاص ‎‎$&‎، لذلك فهو يعيد كامل السلسلة النصية المُطابقة بينما تعيد التعابير mtch[1]‎ و mtch[2]‎ ...إلخ. قيم العناصر المتطابقة سابقًا (تدعى "المراجع الخلفية" [backreferences]) من أجزاء النمط الموجودة بين قوسين. البنية العامة mtch[i]→ str or nil mtch[start, length]→ array mtch[range] → array mtch[name]→ str or nil‎ القيمة المعادة يعيد التعبير mtch[0]‎ كامل السلسلة النصية المُطابقة بينما تعيد التعابير mtch[1]‎ و mtch[2]‎ ...إلخ. قيم ...

تعيد الدّالة itertools.permutations()‎ تبادلات مُتتابعةً بطول مُعيّن من عناصر الكائن القابل للتّكرار المُعطى. تُنتَج التّبادلات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فلن تُكرّر أيّة قيم في كلّ تبادل. البنية العامة itertools.permutations(iterable, r=None) المعاملات iterable الكائن القابل للتّكرار. r طول التّبادلات التي ستُنتَج. قيمته الافتراضيّة هي القيمة None إن لم ...

تعيد الدالة substring()‎ جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها. البنية العامة inline actual fun String.substring(startIndex: Int): String inline actual fun String.substring( startIndex: Int, endIndex: Int ): String fun String.substring(range: IntRange): String fun CharSequence.substring(range: IntRange): String inline fun CharSequence.substring( startIndex: Int, endIndex: Int = length ): String وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)). المعاملات startIndex عدد صحيح ...

تبدِّل الدالة replaceRange()‎ سلسلة معينة من المحارف مكان جزء محدد في سلسلة من المحارف أو سلسلة نصية. سيُرمَى الاستثناء IndexOutOfBoundsException إن وقع مجال الجزء المحدد المراد استبداله خارج مجال سلسلة المحارف أو السلسلة النصية المعطاة. البنية العامة fun CharSequence.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): CharSequence inline fun String.replaceRange( startIndex: Int, endIndex: Int, replacement: CharSequence ): String fun CharSequence.replaceRange( ...

المولّدات هي أداة بسيطة وقوية لإنشاء المكرِّرات. تأخذ المولِّدات صيغة الدوال العادية ولكنّها تستخدم عبارة yield عند إعادة البيانات. في كلّ مرة تستدعى فيها الدالة next()‎ على المولّدات تعود الأخيرة إلى المكان الذي تركته (تتذكر المولّدات جميع القيم والعبارات التي نفّذت أخيرًا). يوضح المثال التالي كيفية إنشاء المولّدات وآلية عملها: def reverse(data):     for index in range(len(data)-1, -1, -1):         yield data[index] >>> >>> for char in reverse('golf'): ...     print(char) ... f l o g يمكن إنجاز كل ما تقوم به المولّدات باستخدام مكرِّرات صنفية (class-based ...

تعيد الدالة subSequence()‎ جزءًا محددًا من سلسلة المحارف التي استُدعيت معها. البنية العامة fun CharSequence.subSequence(range: IntRange): CharSequence inline fun String.subSequence( start: Int, end: Int ): CharSequence هذا الشكل من الدالة قد أُهمِل. المعاملات range مجال من النوع IntRange يحدد الجزء المراد جلبه من سلسلة المحارف المعطاة. start عدد صحيح يشير إلى فهرس العنصر الذي يمثل بداية المجال المراد جلبه. end عدد صحيح يشير إلى فهرس العنصر الذي يمثل نهاية المجال المراد جلبه. القيم المعادة تعاد ...

تمتلك بايثون عددًا من أنواع البيانات المركبة والتي تستخدم لتجميع القيم الأخرى مع بعضها البعض، والقوائم هي أوسع هذه الأنواع وأكثرها شمولًا، ويمكن كتابتها كقائمة من القيم (العناصر) المفصولة عن بعضها البعض بفواصل (،) ومحاطة بأقواس مربعة. يمكن للقوائم أن تتضمّن أنواعًا مختلفة، ولكن عادة ما تكون العناصر كلها من النوع نفسه. >>> squares = [1, 4, 9, 16, 25] >>> squares [1, 4, 9, 16, 25] فهرسة القوائم واقتطاع أجزاء منها كما هو الحال مع السلاسل النصية (والأنواع الأخرى من التسلسلات ...

تنبيه: هذه تقنيّة تجريبيّة، انظر جدول دعم المتصفّحات قبل استخدام هذا التّابع في شيفرة إنتاجيّة. يعيد التّابع Document.caretPositionFromPoint‎()‎ كائنًا من النّوع CaretPosition يحتوي على عقدة DOM ومكان علامة الإقحام (caret) وحدود محارف (character offset) العلامة داخل هذه العقدة. البنية العامة var caretPosition = document.caretPositionFromPoint(float x, float y); المعاملات x الإحداثيّ الأفقيّ لنقطة ما. y الإحداثيّ العمودي لنقطة ما. القيمة المعادة كائن من النّوع CaretPosition. مثال يقوم المثال التّالي بإدخال فراغ سطريً (line break) أينما ضغطت. جزء HTML: <p>Lorem ipsum dolor ...

تمثل الخاصية MatchResult.groups مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. حجم تلك المجموعة يساوي groupCount + 1، إذ يكون groupCount عددَ المجموعات (groups) المتطابقة في التعبير النمطي. تلك المجموعات مُفهرسةٌ بدءًا من العدد 1 وحتى groupCount، والمجموعة ذات الفهرس 0 توافق كل ما تطابق. البنية العامة abstract val groups: MatchGroupCollection القيمة المعادة يعاد كائن من النوع MatchGroupCollection يمثل مجموعة (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. أمثلة في الشيفرة التالية، ننشِئ تعبيرًا نمطيًا باسم regex ...

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

يحرك التابع move()‎ مؤشر الفأرة في الحاسوب المتصل. يُحدَّد الموقع الجديد المراد تحريك المؤشر إليه نسبةً إلى الموقع الحالي للمؤشر. قبل استعمال التابع move()‎، يجب استدعاء التابع begin()‎. البنية العامة Mouse.move(xVal, yPos, wheel); المعاملات xVal محرفٌ ذو إشارة (signed char) يحدِّد مقدار انتقال المؤشر على المحور الأفقي (x-axis). yVal محرفٌ ذو إشارة (signed char) يحدِّد مقدار انتقال المؤشر على المحور الشاقولي (y-axis). wheel محرفٌ ذو إشارة (signed char) يحدِّد مقدار تدوير عجلة الفأرة. القيم المعادة لا يعاد أي شيء. أمثلة ...

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

تمثل الخاصية MatchResult.range مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. البنية العامة abstract val range: IntRange القيمة المعادة يعاد مجالٌ من النوع IntRange يمثل الفهارس التي تحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. أمثلة في الشيفرة التالية، ننشِئ تعبيرًا نمطيًا باسم regex باستخدام التابع Regex()‎، ثم نعرّف سلسلة نصية باسم str، ثم نستخرج منها مجموعات النتائج عبر استدعاء الدالة matchEntire()‎. نستخدم بعدئذٍ الخاصية MatchResult.range لاستخراج الفهارس التي تحدد مكان مُطابقة التعبير النمطي regex في ...

تمثل الخاصية MatchGroup.range مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. البنية العامة val range: IntRange المنصة المطلوبة: JVM. القيم المعادة يعاد مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. انظر أيضًا الخاصية MatchGroup.value: تمثل قيمة مجموعة النتائج التي تم الحصول عليها. مصادر صفحة الخاصيّة MatchGroup.range في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

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

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

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

تعيد الدّالة itertools.combinations_with_replacement()‎ تسلسلات فرعيّة (subsequences) تُعدّ تجميعات ذات طول مُحدّد لعناصر الكائن القابل للتّكرار المُعطى مع السّماح للعناصر بأن تُكرَّر لأكثر من مرّة. تُنتَج التّجميعات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فستكون التّجميعات المُنتجةُ فريدةً كذلك. البنية العامة itertools.combinations_with_replacement(iterable, r) المعاملات iterable الكائن القابل للتّكرار. r طول الصّفوف ...

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.   الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...

يمثل الصنف MatchGroup النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex. data actual class MatchGroup الدوال البانية <init> تنشئ كائنًا من النوع MatchGroup الذي يمثل النتائج التي نحصل عليها من مجموعة واحدة ضمن MatchResult الخاصة بالصنف Regex.   الخاصيات range تمثل مجال الفهارس التي تحدّد مكان مجموعة النتائج التي تم الحصول عليها. value تمثل قيمة مجموعة النتائج التي تم الحصول عليها. الدوال الموروثة equals يبين إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معه. hashCode يعيد الشيفرة ...

تُغلِق الدالة واصفات الملفات بدءً من الواصِف المُمرَّر للمعامل fd_low وصولًا إلى الواصِف الذي يَسبُق الواصِف المُمرَّر للمعامل fd_high، مُتجاهلةً الأخطاء التي قد تَحدُث. البنية العامة closerange(fd_low, fd_high) المعاملات fd_low العدد البادِئ لمجال الواصِفات التي ستُغلَق (سيُغلَق الواصِف المُقابِل لهذا العدد). fd_high العدد المُمثِّل لنهاية مجال الواصِفات التي ستُغلَق (لن يُغلَق الواصِف المُقابِل لهذا العدد). القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). أمثلة يُكافِئ استخدام الدالة تنفيذ الكود (ولكن الدالة تفعل ذلك بشكل أسرع): import ...

يتحقق التابع member?‎ إن كان كائنٌ ما عنصرًا من المجال الذي استُدعي معه. إن كان عنصرا البداية والنهاية عددين، فستتم المقارنة وفقًا لمقدار (magnitude) القيم. البنية العامة member?(obj) → true or false‎ المعاملات obj‎ الكائن المراد التحقق من كونه واقعًا في المجال المعطى.‎ القيمة المعادة تعاد القيمة true إن كان obj عنصرًا من المجال الذي استُدعي معه، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع member?‎: ("a".."z").include?("g") #=> true ("a".."z").include?("A") #=> false ("a".."z").include?("cc") ...

يُطلق الاستثناء RangeError عندما تكون قيمة عددية معطاة خارج النطاق. [1, 2, 3].drop(1 << 100) سيُطلق الاستثناء RangeError بعد تنفيذ هذه الشيفرة: RangeError: bignum too big to convert into `long' مصادر صفحة الصنف RangeError في توثيق روبي الرسمي.

يحسب التابع hash الشيفرة hash للمجال الذي استدعي معه. يكون لمجالين عنصرا بدايتهما ونهايتهما متساويان (وفق المعامل eql?‎)، وقيمة exclude_end?‎ الخاصة بهما متساوية أيضًا نفس رمز التكويد. البنية العامة hash → integer‎ ‎القيمة المعادة يعاد عدد صحيح يمثِّل الشيفرة hash للمجال المعطى. انظر أيضا التابع Object.hash: يحسب الشيفرة hash للكائن الذي استدعي معه. التابع first: يعيد الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. مصادر قسم التابع hash‎ في الصنف Range‎ في توثيق روبي الرسمي.

يبحث التابع bsearch باستخدام خوارزمية البحث الثنائي (binary search) عن قيمة من المجال تحقق الشرط المعطى في مدةO (log n) ‎، إذ n يمثل حجم المجال. البنية العامة bsearch {|obj| block } → value‎ يمكنك استخدام هذا التابع بطريقتين: وضع البحث الأدنى (find-minimum mode)، أو وضع البحث العادي (find-any mode). وفي كلتا الحالتين، يجب أن تكون عناصر المجال مُرتبة (sorted) لأجل الكتلة. في وضع البحث الأدنى (يعد هذا خيارًا جيدًا في الحالات العادية)، يجب أن تُعيد الكتلة إما true أو false، ...

ينشئ التابع new مجالًا من قيمتين تمثِّل إحداها بداية المجال والأخرى نهايته. يمكن ضم قيمة النهاية إلى المجال أو استثنائها منه عبر تمرير القيمة true أو false إلى التابع كمعامل ثالث. البنية العامة new(begin, end, exclude_end=false) → rng‎ المعاملات begin‎ قيمة بداية المجال. end‎ قيمة نهاية المجال. exclude_end‎ قيمة منطقية تحدد إن كانت قيمة النهاية end ستُشمَل ضمن المجال أو تستثنى منه. القيمة الافتراضية هي: false. القيمة المعادة يعاد مجالٌ جديدٌ بدايته القيمة begin ونهايته القيمة end. انظر أيضًا المعامل ==: يتحقق ...

يعيد التابع max أكبر قيمة في المجال المعطى، أو يعيد القيمة nil إن كان عنصر بداية المجال أكبر من عنصر نهايته أو إن كانت قيمة البداية لمجال إقصائي (exclusive، أي أنه يستثني عنصر النهاية) مساوية لقيمة نهايته. يمكن إعطاء كتلة اختيارية لاستبدال تابع المقارنة الافتراضي a <=> b. البنية العامة max → obj max {| a,b | block }→ obj max(n) → obj max(n) {| a,b | block }→ obj‎ المعاملات n‎ ‎عدد صحيح. القيمة المعادة تعاد أكبر قيمة من المجال المعطى، ...

يعيد التابع first الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. البنية العامة first → obj first(n) → an_array‎ المعاملات n‎ ‎عدد صحيح يمثِّل عدد العناصر الأولى المراد جلبها من المجال المعطى. القيمة المعادة يعاد الكائن الأول في المجال المعطى، أو تعاد مصفوفة مكونة من أول n عنصر. أمثلة مثال على استخدام التابع first‎: (10..20).first #=> 10 (10..20).first(3) #=> [10, 11, 12]‎ انظر أيضا التابع last: يعيد الكائن الأخير في المجال، أو يعيد مصفوفة مكونة ...

يحوّل التابع inspect المجال الذي استُدعي معه إلى شكل قابل للطباعة. البنية العامة inspect → string‎ ‎القيمة المعادة يعاد المجال المعطى على شكل سلسلة نصية قابلة للطباعة. انظر أيضا التابع last: يعيد العنصر الأخير في المجال، أو مصفوفة مؤلفة من آخر n عنصر. مصادر قسم التابع inspect‎ في الصنف Range‎ في توثيق روبي الرسمي.

يُكرر التابع each تنفيذ الكتلة المعطاة مع تمرير عناصر المجال إليها بالتتابع. لا يمكن استخدام التابع each إلا ​​إن كان عنصر بداية المجال يدعم التابع succ. يُطلَق الاستثناء TypeError إن لم يٌعرّف ذلك العنصر التابع succ (مثل الصنف Float). في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف enumerator بدلًا من ذلك. البنية العامة each {| i | block } → rng each → an_enumerator‎ القيمة المعادة يعاد مجالٌ ناتج عن تنفيذ الكتلة block على كل عنصر من عناصر المجال المعطى. ...

يعيد التابع end الكائن الذي يحدِّد نهاية المجال. البنية العامة end → obj‎ ‎القيمة المعادة يعاد الكائن الذي يحدد نهاية المجال المعطى. أمثلة مثال على استخدام التابع end‎: (1..10).end #=> 10 (1...10).end #=> 10‎ انظر أيضا التابع begin: يعيد الكائن الذي يحدد بداية المجال. التابع cover?‎: يتحقق إن كان الكائن المُمرَّر إليه محصورًا بين بداية ونهاية المجال. التابع exclude_end?‎: يتحقق إن كان المجال يستثني قيمته النهائية. مصادر قسم التابع end‎ في الصنف Range‎ في توثيق روبي الرسمي.

يتحقق التابع include?‎ إن كان كائنٌ ما عنصرًا من المجال المعطى. إن كان عنصرا البداية والنهاية عددين، فستتم المقارنة وفقًا لمقدار (magnitude) القيم. البنية العامة include?(obj) → true or false‎ المعاملات obj‎ ‎الكائن المراد التحقق من وقوعه ضمن المجال المعطى. القيمة المعادة تعاد القيمة true إن كان objعنصرًا من المجال، أو القيمة false خلاف ذلك. أمثلة مثال على استخدام التابع include?‎: ("a".."z").include?("g") #=> true ("a".."z").include?("A") #=> false ("a".."z").include?("cc") #=> false‎ انظر أيضا المعامل ===: يعيد القيمة true ...

يتحقق التابع cover?‎ إن كان الكائن المُمرَّر إليه محصورًا بين بداية ونهاية المجال. البنية العامة cover?(obj) → true or false‎ يتم التحقق من begin <= obj <= end إن كانت قيمة exclude_end?‎ مضبوطةً إلى القيمة false، أو من begin <= obj < end إن كانت قيمة exclude_end?‎ مضبوطةً إلى القيمة true. المعاملات obj‎ ‎الكائن المراد التحقق من وجوده ضمن المجال المعطى. القيمة المعادة تعاد القيمة true إن كان obj محصورًا بين بداية ونهاية المجال، أو تعاد القيمة false خلاف ذلك. ...

يتحقق التابع exclude_end?‎ إن كان المجال يستثني قيمته النهائية. البنية العامة exclude_end? → true or false‎ ‎القيمة المعادة تعاد القيمة true إن كان المجال يستثني قيمته النهائية. خلا ذلك، تعاد القيمة false. أمثلة مثال على استخدام التابع exclude_end?‎: (1..5).exclude_end? #=> false (1...5).exclude_end? #=> true‎ انظر أيضا التابع eql?‎: يتحقق من تساوي مجالين مع بعضهما بعضًا. مصادر قسم التابع exclude_end?‎ في الصنف Range‎ في توثيق روبي الرسمي.

يعيد التابع size عدد عناصر المجال. يجب أن يكون كل من بداية ونهاية المجال قيمتين عدديتين (من النوع Numeric)، وإلا فستُعاد القيمة nil. البنية العامة size → num‎ ‎القيمة المعادة يعاد عدد عناصر المجال المعطى. أمثلة مثال على استخدام التابع size‎: (10..20).size #=> 11 ('a'..'z').size #=> nil (-Float::INFINITY..Float::INFINITY).size #=> Infinity‎ انظر أيضًا التابع min: يعيد أصغر قيمة من المجال المعطى. مصادر قسم التابع size‎ في الصنف Range‎ في توثيق روبي الرسمي.

يعيد التابع min أصغر قيمة من المجال المعطى، أو يعيد القيمة nil إن كانت قيمة بداية المجال أكبر من قيمة نهايته أو إن كانت قيمة البداية للمجال الإقصائي (exclusive، أي المجال الذي يستثني عنصر النهاية) مساويةً لقيمة عنصر النهاية. يمكن إعطاء كتلة اختيارية لاستبدال تابع المقارنة الافتراضي a <=> b. البنية العامة min → obj min {| a,b | block }→ obj min(n) → array min(n) {| a,b | block }→ array‎ المعاملات n‎ ‎عدد صحيح. القيمة المعادة تعاد أصغر قيمة من ...

يعيد التابع last العنصر الأخير في المجال، أو مصفوفة مؤلفة من آخر n عنصر من عناصر المجال. لاحظ أنه في حال عدم تمرير أية معاملات إلى التابع، فسيعيد الكائن الذي يحدد نهاية المجال، حتى لو كانت قيمة exclude_end?‎ تساوي true. البنية العامة last → obj last(n) → an_array‎ المعاملات n‎ عدد صحيح. يمثِّل عدد العناصر الأخيرة المراد جلبها من المجال. القيمة المعادة يعاد العنصر الأخير في المجال المعطى، أو مصفوفة مؤلفة من آخر n عنصر من المجال. أمثلة مثال على استخدام التابع ...

يعيد التابع begin الكائن الذي يحدِّد بداية مجالٍ ما. البنية العامة begin → obj‎ القيمة المعادة يعاد الكائن الذي يحدِّد بداية المجال المعطى. أمثلة مثال على استخدام التابع begin‎: (1..10).begin #=> 1‎ انظر أيضا التابع end: يعيد الكائن الذي يحدد نهاية مجالٍ ما. التابع cover?‎: يتحقق إن كان الكائن المُمرَّر إليه محصورًا بين بداية ونهاية المجال. مصادر قسم التابع begin‎ في الصنف Range‎ في توثيق روبي الرسمي.

يحوّل التابع to_s المجال الذي استُدعي معه إلى شكل قابل للطباعة. البنية العامة to_s→ string‎ ‎القيمة المعادة تعاد سلسلة نصية تمثل المجال المراد تحويله. انظر أيضا التابع first: يعيد الكائن الأول في المجال، أو يعيد مصفوفة مكونة من أول n عنصر. التابع inspect: يحوّل المجال الذي استُدعي معه إلى شكل قابل للطباعة. مصادر قسم التابع to_s‎ في الصنف Range‎ في توثيق روبي الرسمي.

تعريف الحزم (Package) يُكتب توصيف الحزمة (package) في بداية الملف المصدريّ (source file) بالشكل الآتي: package my.demo import java.util.* // ... ولا يُشترط التوافق ما بين الحزمة (package) والمجلد الذي توجد فيه (directory)، إذ من الممكن أن تتوضع الملفات المصدريّة عشوائيًّا في نظام الملفات. المزيد عن الحزم (packages). تعريف الدوال (Function) إن كانت الدالة بمتحولين من نوع Int وتعيد قيمةً بنوع Int أيضًا، فسيصبح تعريفها بالشكل: fun sum(a: Int, b: Int): Int {   return a + b } أما الشيفرة الآتية فهي لتعريف دالةٍ باسم sum ...

يحذف التابع العنصر في الموقع المحدد من المصفوفة ويعيده. البنية العامة ‎array.pop([i]) المعاملات i موقع العنصر المراد حذفه. القيمة المعادة يعيد التابع العنصر المحذوف من الموقع المحدد في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.pop(3) 4 >>> a1.pop(0) 1 >>> a1.pop(8) Traceback (most recent call last): File "<stdin>", line 1, in <module> IndexError: pop index out of range انظر أيضًا التابع array.append()‎: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة. ...

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

تتحقق الدالة all()‎ إن كانت كافّة عناصر المصفوفة أو المجموعة (collection) التي استُدعيت عبرها تطابق شرطًا منطقيًّا محدَّدًا. البنية العامة يمكن استدعاء الدالة all()‎ للمصفوفات من الأنواع المختلفة كما يلي: inline fun <T> Array<out T>.all(predicate: (T) -> Boolean): Boolean inline fun ByteArray.all(predicate: (Byte) -> Boolean): Boolean inline fun ShortArray.all(predicate: (Short) -> Boolean): Boolean inline fun IntArray.all(predicate: (Int) -> Boolean): Boolean inline fun LongArray.all(predicate: (Long) -> Boolean): Boolean inline fun FloatArray.all(predicate: (Float) -> Boolean): Boolean inline fun DoubleArray.all(predicate: (Double) -> Boolean): Boolean ...

تثبيت روبي توجد طرائق عدَّة لتنزيل وتثبيت روبي على كل منصة وهي: إمَّا استعمال أنظمة مدير الحزم، أو باستعمال المثبِّتات التلقائية، أو باستعمال مدراء روبي. هنالك طريقة أخرى يمكنك بالتأكيد استعمالها لتثبيت روبي وتصريف شيفراتها وهي بنائها من الشيفرة المصدرية مباشرةً. حول روبي يوفر هذا القسم لمحة سريعة عن لغة روبي ونشأتها، وتطورها، ومزاياها التي انفردت بها عن اللغات الأخرى، والتنفيذات المختلفة التي تملكها. البنية العامة بنية اللغة تعد روبي مزيجًا من اللغات البرمجية التالية: Perl، و Smalltalk، و Eiffel، ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

(PHP 4, PHP 5, PHP 7) تملأ الدالة array_pad()‎ المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد. الوصف array array_pad ( array $array , int $size , mixed $value ) تُعيد دالة array_pad()‎‏ نسخةً من المصفوفة array مملوءةً بعناصر بالقيمة value لتصبح بالحجم المحدد size. إذا كان الحجم size موجبًا، فسوف تمتلئ المصفوفة من جهة اليمين، أما إذا كان سالبًا فيكون ذلك من جهة اليسار. أما إذا كانت القيمة المطلقة لـلحجم size أقل من طول المصفوفة array أو مساوية له، فلن يكون ...

(PHP 4, PHP 5, PHP 7) تملأ الدالة array_pad()‎ المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد. الوصف array array_pad ( array $array , int $size , mixed $value ) تُعيد دالة array_pad()‎‏ نسخةً من المصفوفة array مملوءةً بعناصر بالقيمة value لتصبح بالحجم المحدد size. إذا كان الحجم size موجبًا، فسوف تمتلئ المصفوفة من جهة اليمين، أما إذا كان سالبًا فيكون ذلك من جهة اليسار. أما إذا كانت القيمة المطلقة لـلحجم size أقل من طول المصفوفة array أو مساوية له، فلن يكون ...

الصنف التمثيل ‎:active العناصر (مثل الأزرار) التي جرى تفعيلها من المستخدم. وعند استخدام الفأرة سيبدأ «تفعيل» العنصر عندما يضغط المستخدم على الزر الرئيسي لها وينتهي عند إفلات الضغط على ذاك الزر. ‎:checked أزرار انتقاء (radio button) أو صناديق تأشير (checkbox) أو خيارات <option> في عنصر<select> تم تحديدها أو انتقاؤها. يمكن أن يُفعِّل المستخدم هذه الحالة بتفعيل أو انتقاء العنصر. ‎:default أي عنصر مُختار افتراضيًا بين مجموعة من العناصر المتعلقة به؛ ويمكن استخدام هذا الصنف الزائف على أيّة أزرار عادية <button> أو أزرار انتقاء (radio button) ...

تعيد الدّالة itertools.filterfalse()‎ مُكرّرًا يُرشّح عناصر الكائن القابل للتّكرار المُعطى مُعيدًا تلك فقط التي تُعيد لها العبارة المنطقيّة المُعطاة القيمة المنطقيّة False‎. هذه الدّالة تعمل بطريقة مُعاكسة للدّالة filter()‎. البنية العامة itertools.filterfalse(predicate, iterable) المعاملات predicate العبارة المنطقيّة (تكون عادة دالّة) تُحدّد ما إذا كان العنصر سيُعاد أو لا. تُعاد العناصر فقط في حالة أَعَادت لها العبارة المنطقيّة المُعطاة القيمةَ False‎. إن كانت قيمة هذا المُعامل تُساوي القيمة None‎ فستُعاد العناصر التّي تُساوي قيمتها المنطقيّة القيمة False‎. iterable الكائن القابل للتّكرار ...

المشكلة الحاجة إلى استبدال خوارزميّة ما بخوارزميّة أخرى. الحل تعديل محتوى التابع (method body) الذي يُنفِّذ الخوارزمية السابقة ليُنفِّذ الخوارزمية الجديدة. مثال قبل إعادة التصميم تتلخَّص مهمة التابع foundPerson بالبحث عن الأشخاص ذوي الأسماء "Don" أو "John" أو "Kent" وذلك بالمرور بعناصر المصفوفة النصّيّة people باستخدام حلقة for كما في الشيفرة: في لغة Java: String foundPerson(String[] people){ for (int i = 0; i < people.length; i++) { if (people[i].equals("Don")){ return "Don"; ...

بعض المواضيع في Java ومعالجتها في Kotlin عالجت لغة Kotlin العديد من المشاكل الموجودة في Java وهي: التحكُّم بالمرجعيّات الفارغة (null references) عبر نظام الأنواع لا وجود للأنواع الخامّ (raw types) تُعدُّ المصفوفات في Kotlin ثابتة (invariant) للدوال (functions) في Kotlin أنواع مناسبة وهذا ما يتعارض مع التحويلات SAM في Java التنوّع في موقع الاستخدام (use-site variance) دون الحاجة إلى المحارف البديلة (wildcards) لا وجود للاستثناءات المُتحقَّق منها (checked exceptions) في Kotlin ما تمتاز به Java ولا تدعمه Kotlin الاستثناءات ...

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تملأ الدالة array_fill()‎ المصفوفة بقيم محددة. الوصف array array_fill ( int $start_index , int $num , mixed $value ) تملأ الدالة array_fill_keys()‎ عددًا من عناصر المصفوفة يساوي num بقيمة تساوي value بدءًا من الفهرس start_index. المعاملات start_index الفهرس الأول من المصفوفة المعادة. إذا كانت قيمة start_index سالبة، سيكون الفهرس الأول للمصفوفة المعادة مساويًا لقيمة start_index بينما ستبدأ قيم الفهارس التالية من الصفر. num عدد العناصر التي ستملأها الدالة. يجب أن تكون قيمة num ...

تعيد الدّالة 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']] ملاحظات الدّالة ...

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تملأ الدالة array_fill()‎ المصفوفة بقيم محددة. الوصف array array_fill ( int $start_index , int $num , mixed $value ) تملأ الدالة array_fill_keys()‎ عددًا من عناصر المصفوفة يساوي num بقيمة تساوي value بدءًا من الفهرس start_index. المعاملات start_index الفهرس الأول من المصفوفة المعادة. إذا كانت قيمة start_index سالبة، سيكون الفهرس الأول للمصفوفة المعادة مساويًا لقيمة start_index بينما ستبدأ قيم الفهارس التالية من الصفر. num عدد العناصر التي ستملأها الدالة. يجب أن تكون قيمة num ...

يمكن تعريف الدوال مع عدد غير محدّد من المعاملات، وهناك ثلاث صيغ للمعاملات يمكن استخدامها معًا في نفس الوقت. المعاملات ذات القيم الافتراضية يمكن تحديد قيمة افتراضية للمعامل عند تعريفه، وبهذا يمكن استدعاء الدالة مع عدد أقلّ من المعاملات المعرّفة، فعلى سبيل المثال: def ask_ok(prompt, retries=4, reminder='Please try again!'): while True: ok = input(prompt) if ok in ('y', 'ye', 'yes'): ...

تنشئ الدالة ‎downTo()‎ مجالًا متدرجًا (progression) يبدًأ من القيمة القصوى التي استُدعيت معها وينحدر تنازليًّا حتى يصل إلى القيمة الممرّرة إليها. ينبغي أن تكون القيمة الممرَّرة أصغر من القيمة التي استُدعيت معها الدالة، وإلّا ستعيد الدالة مجالا متدرجا فارغًا. البنية العامة infix fun Int.downTo(to: Byte): IntProgression infix fun Long.downTo(to: Byte): LongProgression infix fun Byte.downTo(to: Byte): IntProgression infix fun Short.downTo(to: Byte): IntProgression infix fun Char.downTo(to: Char): CharProgression infix fun Int.downTo(to: Int): IntProgression infix fun Long.downTo(to: Int): LongProgression infix fun Byte.downTo(to: Int): ...

كما في أيّة لغة برمجة فإن لغة Kotlin تحتوي على تعابير للتحكم بالتدفق، وهي: تعبير if، وتعبير when، وحلقة for، وحلقة while. وتدعم كذلك الكلمتين المفتاحيّتَين continue و break المستخدَمتَين في الحلقات (راجع أوامر الرجوع والقفز returns and jump). تعبير if يُعدُّ الشرط if في لغة Kotlin تعبيرًا يعيد قيمة، وبالتالي لا حاجة للصيغة condition ? then : else لأن تعبير if يقوم بهذا الدور كما في الشيفرة الآتية: // الاستخدام الاعتيادي var max = a if (a < b) max = b // ...

الدالة Math.log()‎ تعيد اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي، أي لو أعادت هذه الدالة القيمة y فسيكون التعبير الرياضي ey = x محققًا. الدالة Math.log()‎ في JavaScript تكافئ الدالة ln(x)‎ في الرياضيات. البنية العامة Math.log(x) x العدد التي ستُجرى عليه العملية. القيمة المعادة اللوغاريتم الطبيعي (ذو الأساس e) للعدد المعطي، وإذا كان العدد سالبًا فستُعاد القيمة NaN. الوصف إذا كانت قيمة الوسيط x سالبةً، فستُعيد هذه الدالة القيمة NaN دومًا. لمّا كانت الدالة log هي دالةٌ ساكنة (static method) ...

القيمتان المنطقيتان (البوليانيتان، Boolean) اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. تعدّ القيم المنطقية نوعًا فرعيًا (subtype) من الأعداد الصحيحة، وتسلك القيمتان False و True سلوك القيمتين 0 و 1 على التوالي في معظم السياقات تقريبًا، ويستثنى من ذلك تحويل القيم المنطقية إلى سلاسل نصية، فتعاد حينئذ السلسلتان النصيتان "False" و "True" على التوالي. 1 >>> foo = True 2 >>> bar ...

القيمتان المنطقيتان (البوليانيتان، Boolean) اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. تعدّ القيم المنطقية نوعًا فرعيًا (subtype) من الأعداد الصحيحة، وتسلك القيمتان False و True سلوك القيمتين 0 و 1 على التوالي في معظم السياقات تقريبًا، ويستثنى من ذلك تحويل القيم المنطقية إلى سلاسل نصية، فتعاد حينئذ السلسلتان النصيتان "False" و "True" على التوالي. 1 >>> foo = True 2 >>> bar ...

تعرِض هذه الصفحة عددًا من التعابير الاصطلاحيّة المستخدَمة بكثرةٍ في لغة 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) في الصنف (راجع أصناف البيانات ...

تقدّم بايثون مجموعة من الدوال والتوابع التي تسهّل عملية إنشاء الحلقات التكرارية والاستفادة منها بصورة فعّالة في القواميس والقوائم وغيرها. التابع items()‎ عند المرور على عناصر قاموس، يمكن الحصول على المفتاح والقيمة المرتبطة به في نفس الوقت باستخدام التابع items()‎: >>> knights = {'gallahad': 'the pure', 'robin': 'the brave'} >>> for k, v in knights.items(): ...     print(k, v) ... gallahad the pure robin the brave الدالة enumerate()‎ يمكن الحصول على موقع الفهرس والقيمة المرتبطة به في نفس الوقت عند المرور على عناصر تسلسل معيّن ...