الدوال المضمّنة

يعتمد ما يُعَدّ على نوع القيمة: نقاط Unicode في النص، وعناصر القائمة، ومدخلات القاموس، والقيم التي يولّدها النطاق.

لا تنشئ الدالة قائمةً من النطاق لحساب طوله، ولذلك تظل النتيجة دقيقة حتى عندما يتجاوز العدد ما يستطيع العدد العشري تمثيله بدقة.

يختلف معنى الاحتواء بحسب نوع القيمة. ففي النص تبحث الدالة عن نص فرعي مطابق، وفي القائمة عن عنصر مساوٍ، وفي القاموس عن مفتاح، وفي النطاق تتحقق من أن القيمة من القيم التي يولّدها.

تحتوي؟ اسم بديل للدالة نفسها؛ ولا يختلف السلوك أو نوع النتيجة بين الاسمين.

تقبل الدالة الأرقام الغربية والعربية الهندية، والفاصلَين . و٫، والصيغة الأسية، والإشارة الرمزية أو اللفظية. وتُهمَل المسافات المحيطة بالنص، لكن يجب أن يكون النص كله عددًا صالحًا.

إذا لم يحتوِ النص على فاصل عشري أو أس، تُعيد الدالة عددًا صحيحًا دقيقًا. أما وجود فاصل عشري أو أس فيجعل النتيجة عشرية، حتى إذا كانت قيمتها الرياضية عددًا صحيحًا.

يستخدم الاختبار القواعد نفسها التي تستخدمها .إلى عدد(): المسافات المحيطة، وأنواع الأرقام، والفاصل العشري، والصيغة الأسية، وأن تكون النتيجة العشرية محدودة وليست لا نهائية.

يُعيد خطأ عندما يكون النص غير صالح، من دون رفع خطأ تحويل؛ لذلك يمكنك استخدامه قبل التحويل لتجنّب الخطأ.

تُحذف مسافات التحويل المحيطة بالنص أولًا. بعد ذلك تعيد صحيح القيمة الصادقة، بينما تعيد الصيغتان خطأ وخاطئ القيمة الكاذبة.

لا يقبل التحويل كلمات إضافية مثل نعم ولا، ولا يحوّل الأعداد إلى قيم منطقية.

يقبل الاختبار الصيغ نفسها التي تقبلها .إلى قيمة منطقية() بعد حذف المسافات المحيطة. ويُعيد خطأ للنصوص الأخرى من دون رفع خطأ تحويل.

يعيد النص نفسه من غير تغيير. ويحوّل الصحيح والعشري والقيمة المنطقية والعدم إلى نصوصها القانونية كما تظهر في زيد.

يحافظ تحويل العدد العشري على ما يميّزه عن الصحيح، مثل اللاحقة .0 والصفر السالب. ولا تدعم النسخة 0.0.1 تحويل القوائم والقواميس والنطاقات إلى نص.

إذا كان العدد صحيحًا كانت النتيجة عددًا صحيحًا، وإذا كان عشريًا كانت النتيجة عددًا عشريًا. ولا تغيّر الدالة الأعداد غير السالبة، وتحول الصفر العشري السالب إلى 0.0 موجب.

انتبه إلى أولوية الاستدعاء: يجب وضع العدد المنفي بين قوسين، لأن ناقص 5.مطلق() يعني نفي نتيجة 5.مطلق().

يعيد المستقبل نفسه عندما يكون صحيحًا. أما العشري فيُقرّب إلى أقرب صحيح، وتُقرّب حالة المنتصف بعيدًا عن الصفر: 2.5 إلى 3 و-2.5 إلى -3.

النتيجة دائمًا من نوع العدد الصحيح، حتى عندما كان المستقبل عشريًا ذا قيمة صحيحة.

تُعيد الدالة صحيح لكل عدد صحيح، كما تُعيده للعدد العشري الذي ليس له جزء كسري، مثل 7.0، مع بقائه عشريًا من حيث النوع.

تعمل الدالة على الأعداد الصحيحة وعلى الأعداد العشرية التي ليس لها جزء كسري، مثل 12.0. ولا تُعرَّف الزوجية لعدد ذي جزء كسري.

تعمل الدالة على الأعداد الصحيحة وعلى الأعداد العشرية التي ليس لها جزء كسري. وهي المقابل المنطقي لـ .زوجي؟() لكل قيمة صالحة لاختبار الزوجية.

تُنشئ الدالة قائمةً جديدة وتنقل إليها العناصر الحالية كما هي، ثم تضيف المعامل عنصرًا أخيرًا. ولا تتغيّر القائمة الأصلية.

النسخة سطحية؛ فإذا احتوت القائمة على قائمة أو قاموس متداخل، يبقى العنصر الداخلي نفسه مشتركًا بين الأصل والنسخة.

في القائمة يحذف أول عنصر مساوٍ للمعامل فقط. وفي القاموس يعامل المعامل بوصفه مفتاحًا نصيًا ويحذف مدخله مع الحفاظ على ترتيب المدخلات الباقية.

لا تغيّر الدالة القيمة الأصلية. وإذا لم توجد القيمة أو المفتاح، ترفع الدالة خطأً بدلًا من إعادة نسخة مطابقة قد تخفي خطأً في البرنامج.

تُعدِّل الدالة القائمة الأصلية بدلًا من إنشاء قائمة جديدة، ثم تُعيد القائمة نفسها. ولذلك يمكنك استدعاء دالة تعديل أخرى مباشرةً على النتيجة.

في القائمة تحذف الدالة أول عنصر مساوٍ للمعامل. وفي القاموس تحذف المدخل ذي المفتاح النصي المحدد.

يحدث التغيير على القيمة الأصلية نفسها، وتُعاد القيمة بعد تعديلها لتمكين الاستدعاءات المتتابعة. ويُسمح بحذف مفتاح من القاموس أثناء التكرار المباشر عليه، بخلاف إضافة مفتاح جديد.

تختار الدالة فهرسًا عشوائيًا صالحًا داخل القائمة أو النطاق، ثم تُعيد القيمة الموجودة في ذلك الموضع. ويعتمد التوزيع على مولّد الأعداد العشوائية في بيئة التشغيل.

لا تُنسخ القيمة المختارة. فإذا كانت قائمةً أو قاموسًا متداخلًا، فإن تعديلها يغيّر العنصر نفسه داخل القائمة الأصلية. وعشوائية اسم بديل للدالة نفسها.