blockly > CodeGenerator > provideFunction_

Metoda CodeGenerator.provideFunction_()

Zdefiniuj funkcję zdefiniowaną przez programistę (nie procedurę zdefiniowaną przez użytkownika), która zostanie uwzględniona w wygenerowanym kodzie. Służy do tworzenia prywatnych funkcji pomocniczych. Przy pierwszym wywołaniu z określoną nazwą o wybranej nazwie kod zostaje zapisany i generowana jest rzeczywista nazwa. Kolejne wywołania z tą samą wartością o tej samej nazwie nie mają żadnego efektu, ale mają tę samą wartość zwracaną.

Od elementu wywołującego zależy to, czy ta sama żądana_nazwa nie jest używana w różnych funkcjach pomocniczych (np. należy użyć zdarzeń „colourRandom” i „listRandom”, a nie „random”). Nie istnieje niebezpieczeństwo kolizji z zarezerwowanymi słowami, zdefiniowanymi przez użytkownika nazwami zmiennych lub procedur.

Kod jest zwracany po wywołaniu funkcji CodeGenerator.finish().

Podpis:

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

Parametry

Parametr	Typ	Opis
desiredName	ciąg znaków	Żądana nazwa funkcji (np. mathIsPrime).
kod	string[] | ciąg	Lista instrukcji lub jeden wielowierszowy ciąg kodu. Do obsługi wcięć używaj znaku „ ” (zostaną one zastąpione).

Zwraca:

ciąg znaków

Rzeczywista nazwa nowej funkcji. Może się różnić od tej wartości, jeśli nazwa została już zajęta przez użytkownika.