تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
blockly > CodeGenerator > provideFunction_
طريقة CodeGenerator.ProvideFunction_()
حدد دالة يحددها المطوّر (وليس إجراءً من تحديد المستخدم) ليتم تضمينها في الرمز الذي تم إنشاؤه. يُستخدم لإنشاء دوال مساعد خاصة. في المرة الأولى التي يتم فيها استدعاء هذا بواسطة renameName، يتم حفظ الكود ويتم إنشاء اسم فعلي. ويُرجى العِلم بأنّ الاستدعاءات اللاحقة التي لها الاسم requiredName نفسه ليس له أي تأثير، لكن يكون لها القيمة المعروضة نفسها.
ويرجع الأمر إلى المتصل بالتأكّد من عدم استخدام نفس بالشكل مطلوبName في الدوال المساعدة المختلفة (على سبيل المثال، استخدِم "colourSpam" و"listRAM" وليس "عشوائية"). وليس هناك خطر الاصطدام بالكلمات المحجوزة أو أسماء المتغيرات أو الإجراءات التي يحددها المستخدم.
تحصل التعليمة البرمجية على ناتج عند استدعاء CodeGenerator.finish().
Signature:
provideFunction_(desiredName: string, code: string[] | string): string;
المعلمات
| المعلمة |
النوع |
الوصف |
| desiredName |
سلسلة |
الاسم الذي تريده للدالة (مثل MahIsPrime). |
| رمز |
سلسلة[] | سلسلة |
تمثّل هذه السمة قائمة من العبارات أو سلسلة رمز برمجي متعددة الأسطر. استخدم ' " المسافات البادئة (سيتم استبدالها). |
المرتجعات:
سلسلة
تمثّل هذه السمة الاسم الفعلي للدالة الجديدة. قد يختلف هذا الحقل عنrequiredName إذا سبق أن استخدم المستخدم طلب البحث.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eCodeGenerator.provideFunction_()\u003c/code\u003e defines developer-defined helper functions for inclusion in the generated code, assigning a unique name to avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003eCalling this method multiple times with the same \u003ccode\u003edesiredName\u003c/code\u003e has no effect but returns the previously assigned unique name.\u003c/p\u003e\n"],["\u003cp\u003eGenerated helper function code is output when \u003ccode\u003eCodeGenerator.finish()\u003c/code\u003e is called.\u003c/p\u003e\n"],["\u003cp\u003eThe method takes the desired function name and code as input, returning the actual assigned function name.\u003c/p\u003e\n"],["\u003cp\u003eEnsure distinct \u003ccode\u003edesiredName\u003c/code\u003e values for different helper functions to prevent unintended behavior.\u003c/p\u003e\n"]]],["The `provideFunction_()` method defines developer-created helper functions for generated code. It takes a `desiredName` and `code` (string or string array). The first call with a `desiredName` saves the `code` and generates a function name. Subsequent calls with the same `desiredName` are ignored. The function name is returned, and may differ from `desiredName` if a name conflict is detected. The code is output when `CodeGenerator.finish()` is called. The method is used to prevent name collisions with user-defined items.\n"],null,[]]
