blockly > CodeGenerator > provideFunction_

CodeGenerator.provideFunction_()-Methode

Definieren Sie eine vom Entwickler definierte Funktion (keine benutzerdefinierte Prozedur), die in den generierten Code aufgenommen werden soll. Wird zum Erstellen privater Hilfsfunktionen verwendet. Beim ersten Aufruf mit einem Wert für den gewünschten Namen wird der Code gespeichert und ein tatsächlicher Name generiert. Nachfolgende Aufrufe mit dem Wert „wantName“ haben keine Auswirkungen, haben aber denselben Rückgabewert.

Der Aufrufer muss sicherstellen, dass für verschiedene Hilfsfunktionen nicht derselbe Wert verwendet wird (z.B. "colourRandom" und "listRandom", nicht "Random"). Es besteht keine Gefahr, dass Kollisionen mit reservierten Wörtern oder benutzerdefinierten Variablen- oder Prozedurnamen auftreten.

Der Code wird ausgegeben, wenn CodeGenerator.complete() aufgerufen wird.

Unterschrift:

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

Parameter

Parameter Typ Beschreibung
desiredName String Der gewünschte Name der Funktion (z.B. mathIsPrime).
Code String[] | String Eine Liste von Anweisungen oder ein mehrzeiliger Codestring. Verwenden Sie ' ' für Einzüge (sie werden ersetzt).

Gibt zurück:

String

Der tatsächliche Name der neuen Funktion. Dieser kann sich vom gewünschtenName unterscheiden, wenn er bereits vom Nutzer verwendet wird.