blockly > CodeGenerator > provideFunction_

طريقة CodeGenerator.provideFunction_()

تعريف دالة من تحديد مطوّر البرامج (وليس إجراءً من تحديد المستخدم) لتضمينها في الرمز الذي تم إنشاؤه. تُستخدَم لإنشاء دوال مساعد خاصة. وفي المرة الأولى التي يتم فيها استدعاء هذه الدالة مع requiredName مُعطى، يتم حفظ الرمز وإنشاء اسم فعلي. لا يكون للاستدعاءات اللاحقة التي لها نفس الشكل المطلوب "الاسم" نفسه أي تأثير، غير أنّ لها القيمة المعروضة نفسها.

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

تحصل التعليمة البرمجية على مخرج عند استدعاء CodeGenerator.finish().

Signature:

provideFunction_(desiredName: string, code: string[] | string): string;

المَعلمات

المَعلمة	Type	الوصف
desiredName	سلسلة	الاسم المطلوب للدالة (على سبيل المثال،MathIsPrime).
رمز	سلسلة[] | سلسلة	تمثّل هذه السمة قائمة من العبارات أو سلسلة رمز واحدة متعددة الأسطر. استخدم ' ' للمسافة البادئة (سيتم استبدالها).

المرتجعات:

سلسلة

الاسم الفعلي للدالة الجديدة. قد يختلف هذا الخيار عن requiredName إذا كان المستخدم قد استخدم الاسم الأول.