Scrivere una Funzione - Cronologia

Vuott il 19:02, 7 feb 2025

2025-02-07T19:02:05Z

← Versione meno recente		Versione delle 13:02, 7 feb 2025
Riga 122:		Riga 122:
	Se la Funzione deve restituire più di un dato non è possibile utilizzare l'istruzione ''Return'' con una variabile ordinaria, giacché essa restituisce una sola variabile.		Se la Funzione deve restituire più di un dato non è possibile utilizzare l'istruzione ''Return'' con una variabile ordinaria, giacché essa restituisce una sola variabile.

	Per ottenere da una medesima Funzione due o più risultati (quindi <U>senza</u> dover utilizzare una variabile globale), possiamo utilizzare ~~due~~ modalità:		Per ottenere da una medesima Funzione due o più risultati (quindi <U>senza</u> dover utilizzare una variabile globale), possiamo utilizzare almeno tre modalità:
	* uso di una variabile vettoriale (se i dati sono di tipi diversi allora si userà un vettore di tipo "Variant" per contenere quei dati diversi) ~~oppure~~ di una ''Struttura'' (~~sopratutto~~ se i dati, da passare, sono di tipi diversi);		* uso di una ''variabile vettoriale'', ossia un ''array'', (se i dati sono di tipi diversi allora si userà un vettore di tipo "Variant" per contenere quei dati diversi);
	* il passaggio per ''indirizzo'' (vedi paragrafo successivo).		* uso di una ''Struttura'' (soprattutto se i dati, da passare, sono di tipi diversi);
			* uso del passaggio per ''indirizzo'' (vedi paragrafo successivo).

	====Uso di un vettore come ritorno di una Funzione====		====Uso di un vettore come ritorno di una Funzione====

Vuott il 18:59, 7 feb 2025

2025-02-07T18:59:57Z

← Versione meno recente		Versione delle 12:59, 7 feb 2025
Riga 120:		Riga 120:

	===...e se la Funzione deve restituire due o più dati ?===		===...e se la Funzione deve restituire due o più dati ?===
	Se la Funzione deve restituire più di un dato non è possibile utilizzare l'istruzione ''Return'' con una variabile ordinaria, giacché essa restituisce ~~un solo dato~~.		Se la Funzione deve restituire più di un dato non è possibile utilizzare l'istruzione ''Return'' con una variabile ordinaria, giacché essa restituisce una sola variabile.

	Per ottenere da una medesima Funzione due o più risultati (quindi <~~SPAN Style="text-decoration:underline"~~>senza</~~span~~> dover utilizzare una variabile globale), possiamo utilizzare due modalità:		Per ottenere da una medesima Funzione due o più risultati (quindi <U>senza</u> dover utilizzare una variabile globale), possiamo utilizzare due modalità:
	* uso di una variabile vettoriale o di una ''Struttura'';		* uso di una variabile vettoriale (se i dati sono di tipi diversi allora si userà un vettore di tipo "Variant" per contenere quei dati diversi) oppure di una ''Struttura'' (sopratutto se i dati, da passare, sono di tipi diversi);
	* il passaggio per ''indirizzo'' (vedi paragrafo successivo).		* il passaggio per ''indirizzo'' (vedi paragrafo successivo).

Vuott il 23:03, 21 giu 2024

2024-06-21T23:03:44Z

← Versione meno recente		Versione delle 17:03, 21 giu 2024
Riga 561:		Riga 561:

	[5] Possiamo distinguere quattro tipi di ''Funzioni'':		[5] Possiamo distinguere quattro tipi di ''Funzioni'':
	* native ed autonome. Si tratta di quelle Funzione che sussistono di per sé all'interno di Gambas, avendo così una ''dignità'' propria (ad esempio: ''Alloc()'', ''SizeOf()'', ''Max()'' e così via).		* native ed autonome. Si tratta di quelle Funzione che sussistono di per sé all'interno di Gambas, avendo così una ''dignità'' propria (ad esempio: "Alloc()", "SizeOf()", "Max()" e così via).
	* ''metodi'' di Classi Gambas. Si tratta di quelle Funzioni di Gambas che non sono ''autonome'', ma esistono in quanto risorse tipiche di una Classe. Tali Funzioni (''Metodi'') possono essere utilizzati <SPAN Style="text-decoration:underline">solo se richiamate attraverso un Oggetto</span> di una Classe. Esempi di tali Funzioni: ''Object.<FONT Color=~~#B22222~~>SizeOf()</font>'', ''Button1.<FONT Color=~~#B22222~~>Move()</font>'', ''vettore.<FONT Color=~~#B22222~~>Push()</font>'', ''Paint.<FONT Color=~~#B22222~~>DrawImage()</font>'' e così via.		* ''metodi'' di Classi Gambas. Si tratta di quelle Funzioni di Gambas che non sono ''autonome'', ma esistono in quanto risorse tipiche di una Classe. Tali Funzioni (''Metodi'') possono essere utilizzati <SPAN Style="text-decoration:underline">solo se richiamate attraverso un Oggetto</span> di una Classe. Esempi di tali Funzioni: "Object.<FONT Color=red>SizeOf()</font>", "Button1.<FONT Color=red>Move()</font>", "vettore.<FONT Color=red>Push()</font>", "Paint.<FONT Color=red>DrawImage()</font>" e così via.
	* Funzioni scritte dal programmatore (oggetto della presente pagina): sono appunto specifiche Funzioni, scritte dal programmatore, per assolvere ad un particolare compito che si esaurisce con l'applicazione, nella quale la Funzione è stata appositamente creata.		* Funzioni scritte dal programmatore (oggetto della presente pagina): sono appunto specifiche Funzioni, scritte dal programmatore, per assolvere ad un particolare compito che si esaurisce con l'applicazione, nella quale la Funzione è stata appositamente creata.
	* Funzioni esterne. Tali funzioni <SPAN Style="text-decoration:underline">non</span> appartengono al linguaggio Gambas, bensì a librerie esterne di funzioni. Tali funzioni esterne possono essere richiamate e gestite da Gambas mediante la parola [[Extern:_richiamare_funzioni_esterne_a_Gambas\|Extern]].		* Funzioni esterne. Tali funzioni <SPAN Style="text-decoration:underline">non</span> appartengono al linguaggio Gambas, bensì a librerie esterne di funzioni. Tali funzioni esterne possono essere richiamate e gestite da Gambas mediante la parola [[Extern:_richiamare_funzioni_esterne_a_Gambas\|Extern]].

Vuott il 23:01, 21 giu 2024

2024-06-21T23:01:07Z

Mostra modifiche

Vuott il 01:33, 14 nov 2022

2022-11-14T01:33:08Z

← Versione meno recente		Versione delle 19:33, 13 nov 2022
Riga 36:		Riga 36:
	La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>		La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>
	<BR>Anche il dato ritornato dall'istruzione ''Return'' può essere in sostanza considerato un parametro ''potenziale'', sebbene in questo caso in "uscita" dalla Funzione.		<BR>Anche il dato ritornato dall'istruzione ''Return'' può essere in sostanza considerato un parametro ''potenziale'', sebbene in questo caso in "uscita" dalla Funzione.
	~~<BR>~~Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:
			Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:
	'''Public''' Sub Main()		'''Public''' Sub Main()

Vuott il 01:32, 14 nov 2022

2022-11-14T01:32:29Z

← Versione meno recente		Versione delle 19:32, 13 nov 2022
Riga 30:		Riga 30:

	Inoltre, <SPAN Style="text-decoration:underline">se è previsto</span> che la Funzione ''chiamante'' passi alla Funzione ''chiamata'' uno o più valori, affinché essi vengano processati dalle istruzioni contenute dalla Funzione ''chiamata'', detti valori pasati devono essere del tipo <SPAN Style="text-decoration:underline">identico</span> a quello dichiarato nella Funzione ''chiamata''. In tal senso i valori, passati dalla Funzione ''chiamante'' sono definiti «''Parametri attuali'' » o «''argomenti'' », mentre i valori dichiarati - e quindi poi ricevuti - dalla Funzione ''chiamata'' (ove la Funzione è definita) sono nominati «''Parametri formali'' ».		Inoltre, <SPAN Style="text-decoration:underline">se è previsto</span> che la Funzione ''chiamante'' passi alla Funzione ''chiamata'' uno o più valori, affinché essi vengano processati dalle istruzioni contenute dalla Funzione ''chiamata'', detti valori pasati devono essere del tipo <SPAN Style="text-decoration:underline">identico</span> a quello dichiarato nella Funzione ''chiamata''. In tal senso i valori, passati dalla Funzione ''chiamante'' sono definiti «''Parametri attuali'' » o «''argomenti'' », mentre i valori dichiarati - e quindi poi ricevuti - dalla Funzione ''chiamata'' (ove la Funzione è definita) sono nominati «''Parametri formali'' ».

	La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>

	I ''Parametri formali'' enunciati nella definizione di una Funzione, possono essere considerati come parametri ''potenziali'', nel senso che essi rappresentano il tipo di dato che la Funzione può ricevere.		I ''Parametri formali'' enunciati nella definizione di una Funzione, possono essere considerati come parametri ''potenziali'', nel senso che essi rappresentano il tipo di dato che la Funzione può ricevere.
	<BR>I ''Parametri attuali'' o ''Argomenti'' sono appunto i dati effettivamente passati alla Funzione "chiamata" attraverso la Funzione "chiamante" nello stretto rispetto dei tipi di dati attesi dalla definizione della Funzione medesima.		<BR>I ''Parametri attuali'' o ''Argomenti'' sono appunto i dati effettivamente passati alla Funzione "chiamata" attraverso la Funzione "chiamante" nello stretto rispetto dei tipi di dati attesi dalla definizione della Funzione medesima.

			La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>
	<BR>Anche il dato ritornato dall'istruzione ''Return'' può essere in sostanza considerato un parametro ''potenziale'', sebbene in questo caso in "uscita" dalla Funzione.		<BR>Anche il dato ritornato dall'istruzione ''Return'' può essere in sostanza considerato un parametro ''potenziale'', sebbene in questo caso in "uscita" dalla Funzione.
			<BR>Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:
	Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:
	'''Public''' Sub Main()		'''Public''' Sub Main()

Vuott il 01:30, 14 nov 2022

2022-11-14T01:30:21Z

← Versione meno recente		Versione delle 19:30, 13 nov 2022
Riga 32:		Riga 32:

	La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>		La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>

			I ''Parametri formali'' enunciati nella definizione di una Funzione, possono essere considerati come parametri ''potenziali'', nel senso che essi rappresentano il tipo di dato che la Funzione può ricevere.
			<BR>I ''Parametri attuali'' o ''Argomenti'' sono appunto i dati effettivamente passati alla Funzione "chiamata" attraverso la Funzione "chiamante" nello stretto rispetto dei tipi di dati attesi dalla definizione della Funzione medesima.
			<BR>Anche il dato ritornato dall'istruzione ''Return'' può essere in sostanza considerato un parametro ''potenziale'', sebbene in questo caso in "uscita" dalla Funzione.

	Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:		Mostriamo di seguito un semplice esempio pratico con la modalità più comune di ritorno di valore:

Vuott il 00:25, 9 nov 2022

2022-11-09T00:25:27Z

@@ Riga 551: / Riga 551: @@
 * Funzioni esterne. Tali funzioni <SPAN Style="text-decoration:underline">non</span> appartengono al linguaggio Gambas, bensì a librerie esterne di funzioni. Tali funzioni esterne possono essere richiamate e gestite da Gambas mediante la parola [[Extern:_richiamare_funzioni_esterne_a_Gambas|Extern]].
-[6] Anche se non è una regola rigida che possa dare errore, in Gambas una Funzione ''restituisce'' sempre un valore alla Funzione ''chiamante''; pertanto si preferisce definirla con la parola chiave ''Function'' (preceduta dalla parola chiave ''Public'' o ''Private'' a seconda ovviamente delle necessità), rispetto ad una routine che ''non'' restituisce alcun valore, e che - in tal caso - verrà definita con la parola chiave ''Sub'' o ''Procedure'' (preceduta dalla parola chiave ''Public'' o ''Private'' a seconda ovviamente delle necessità).
+[6] Riguardo alla differenza fra le parole-chiavi "Sub", Procedure" e "Function" si veda la seguente pagina della wiki: [[Differenza fra Sub, Procedure e Function]].
 [7] In Gambas elementi complessi come gli Oggetti vengono sempre passati come Riferimento, ovvero l'indirizzo di memoria in cui si trovano. Riguardo invece alle normali variabili di tipi base (Byte, Short, Integer/String/Long ecc.) queste non sono Oggetti ma "valori" ben precisi, che vengono passati come "Valore", e non come locazione di memoria. Questa differenza implica che, per quanto riguarda gli Oggetti, ogni modifica al suo contenuto viene mantenuta, mentre per le variabili, dato che ne viene passata una copia del valore, queste vengono perse all'uscita della stessa funzione che le gestisce.

Vuott il 00:14, 9 nov 2022

2022-11-09T00:14:07Z

← Versione meno recente		Versione delle 18:14, 8 nov 2022
Riga 29:		Riga 29:
	Una Funzione, per essere utilizzata dal processo del programma, deve essere invocata, chiamata da una specifica Funzione ''chiamante''. Tale Funzione ''chiamante'' deve avere un nome identificativo <SPAN Style="text-decoration:underline">identico</span> a quello della Funzione ''chiamata''.		Una Funzione, per essere utilizzata dal processo del programma, deve essere invocata, chiamata da una specifica Funzione ''chiamante''. Tale Funzione ''chiamante'' deve avere un nome identificativo <SPAN Style="text-decoration:underline">identico</span> a quello della Funzione ''chiamata''.

	Inoltre, <SPAN Style="text-decoration:underline">se è previsto</span> che la Funzione ''chiamante'' passi alla Funzione ''chiamata'' uno o più valori, affinché essi vengano processati dalle istruzioni contenute dalla Funzione ''chiamata'', detti valori pasati devono essere del tipo <SPAN Style="text-decoration:underline">identico</span> a quello dichiarato nella Funzione ''chiamata''. In tal senso i valori, passati dalla Funzione ''chiamante'' sono definiti " ''argomenti'' ", mentre i valori dichiarati - e quindi poi ricevuti - dalla Funzione ''chiamata'' sono ~~definiti "~~ ''~~parametri~~'' ".		Inoltre, <SPAN Style="text-decoration:underline">se è previsto</span> che la Funzione ''chiamante'' passi alla Funzione ''chiamata'' uno o più valori, affinché essi vengano processati dalle istruzioni contenute dalla Funzione ''chiamata'', detti valori pasati devono essere del tipo <SPAN Style="text-decoration:underline">identico</span> a quello dichiarato nella Funzione ''chiamata''. In tal senso i valori, passati dalla Funzione ''chiamante'' sono definiti «''Parametri attuali'' » o «''argomenti'' », mentre i valori dichiarati - e quindi poi ricevuti - dalla Funzione ''chiamata'' (ove la Funzione è definita) sono nominati «''Parametri formali'' ».

	La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>		La Funzione ''chiamata'' ritorna <SPAN Style="text-decoration:underline">sempre</span> un valore, che è il risultato delle operazioni svolte dalle istruzioni presenti nella Funzione. <SUP>[[[#Note\|<B>Nota 6</b>]]]</sup>

Vuott il 00:09, 9 nov 2022

2022-11-09T00:09:07Z

← Versione meno recente		Versione delle 18:09, 8 nov 2022
Riga 1:		Riga 1:
	Una '''Funzione''' <FONT Color=blue><SUP>[note:</sup></font> [[#Note\|<SUP>1</sup>]] [[#Note\|<SUP>2</sup>]] [[#Note\|<SUP>3</sup>]] [[#Note\|<SUP>4</sup>]] [[#Note\|<SUP>5</sup>]]<FONT Color=blue><SUP>]</sup></font> è una routine, chiamata da una routine principale, alla quale è delegato il compito di svolgere una serie di operazioni, e delle quali essa restituisce alla routine principale ''chiamante'' ~~il risultato~~.		Una '''Funzione''' <FONT Color=blue><SUP>[note:</sup></font> [[#Note\|<SUP>1</sup>]] [[#Note\|<SUP>2</sup>]] [[#Note\|<SUP>3</sup>]] [[#Note\|<SUP>4</sup>]] [[#Note\|<SUP>5</sup>]]<FONT Color=blue><SUP>]</sup></font> è una routine, chiamata da una routine principale, alla quale è delegato il compito di svolgere una serie di operazioni, e delle quali essa restituisce il risultato alla routine principale ''chiamante''.

	La Funzione è l'operazione attinente ad una fase del processo del programma.		La Funzione è l'operazione attinente ad una fase del processo del programma.

	Poiché una funzione deve eseguire ''un'' compito, si ritiene non opportuno scrivere una funzione per eseguire più istruzioni insieme. E' preferibile scrivere funzioni per singoli compiti ed una ulteriore funzione che svolga l'operazione complessa, invocando le funzioni precedenti.

	=Dichiarazione di una Funzione=		=Dichiarazione di una Funzione=
	Va precisato che in Gambas <SPAN Style="text-decoration:underline">non</span> è prevista nel codice del programma la ''dichiarazione'' di una Funzione.		Va precisato che in Gambas <SPAN Style="text-decoration:underline">non</span> è prevista nel codice del programma la ''dichiarazione'' di una Funzione.

	=Definizione di una Funzione=		=Definizione di una Funzione=
	La ~~funzione~~, creata dal programmatore, in Gambas è sostanzialmente ''definita'' con il seguente prototipo:		La "definizione" della Funzione stabilisce:
			* il nome (''Identificatore'' ) della Funzione medesima;
			* i valori in entrata, passati dalla omonima Funzione ''chiamante'', definiti «''parametri formali'' »;
			* il blocco delle istruzioni che compiono le operazioni necessarie per ottenere il risultato previsto dalla Funzione;
			* il valore di ritorno ottenuto dalla predette istruzioni operative.
			Gli eventuali "''parametri formali'' " di una Funzione sono posti all'interno di due parentesi tonde, nelle quali sono specificati di ciascun parametro l'identificatore e il tipo di dato.
			<BR>In Gambas ogni Identificatore di Funzione è consentito per una sola Funzione. Pertanto non possono esssere definite due o più Funzioni aventi il medesimo nome (identificatore).
			<BR> Il Blocco delle istruzionidi una Funzione rappresenta il valore permanente associato a una Funzione. In esso può essere inserita qualsiasi istruzione, compresa una chiamata di Funzione.

			La Funzione, creata dal programmatore, in Gambas è sostanzialmente ''definita'' con il seguente prototipo:
	[Public/Private] Function ''Nome_Identificativo''( [''Parametro'' As ''tipo_di_dato'', ''...idem...''] ) As ''Tipo_di_dato_ritornato''		[Public/Private] Function ''Nome_Identificativo''( [''Parametro'' As ''tipo_di_dato'', ''...idem...''] ) As ''Tipo_di_dato_ritornato''

Riga 19:		Riga 25:

	End		End
	La parola chiave '''~~Function~~''', che specifica e definisce una Funzione ''chiamata'', può essere preceduta dalla parola chiave ''Public'' o ''Private'' a seconda delle necessità di visibilità della Funzione medesima.		La parola chiave '''FUNCTION''', che specifica e definisce una Funzione ''chiamata'', può essere preceduta dalla parola chiave ''Public'' o ''Private'' a seconda delle necessità di visibilità della Funzione medesima.

	Una Funzione, per essere utilizzata dal processo del programma, deve essere invocata, chiamata da una specifica Funzione ''chiamante''. Tale Funzione ''chiamante'' deve avere un nome identificativo <SPAN Style="text-decoration:underline">identico</span> a quello della Funzione ''chiamata''.		Una Funzione, per essere utilizzata dal processo del programma, deve essere invocata, chiamata da una specifica Funzione ''chiamante''. Tale Funzione ''chiamante'' deve avere un nome identificativo <SPAN Style="text-decoration:underline">identico</span> a quello della Funzione ''chiamata''.
Riga 68:		Riga 74:
	Il passaggio per '''Valore''' è senz'altro la modalità più frequente di passare dei dati ad una Funzione chiamata.		Il passaggio per '''Valore''' è senz'altro la modalità più frequente di passare dei dati ad una Funzione chiamata.

	Nel passaggio per ''Valore'' viene ~~- appunto -~~ passato un valore o sotto forma di dato effettivo (ad esempio direttamente un dato numerico oppure indirettamente mediante una variabile - ad esempio di tipo Byte, Short, etc. - che contiene e dunque fornisce un valore.		Nel passaggio per ''Valore'' viene passato un valore o sotto forma di dato effettivo (ad esempio direttamente un dato numerico) oppure indirettamente mediante una variabile (ad esempio di tipo Byte, Short, Integer, etc.) che contiene e dunque fornisce un valore.

	Con il passaggio per ''Valore'' viene effettuata una ''copia'' della variabile passata alla Funzione chiamata come argomento della routine principale chiamante. Inoltre, le modifiche alla variabile del parametro passato, effettuate nella Funzione chiamata, restano confinate nell'ambito locale di detta Funzione secondaria. Ciò significa che la variabile, passata come parametro dalla routine chiamante a quella chiamata, non vede modificarsi il suo valore, nonostante la sua copia abbia subito una modifica del proprio valore a seguito di una o più operazioni nella Funzione secondaria chiamata. La viariabile presente nella routine principale chiamante resta intatta, immodificata, qualunque cosa avvenga alla sua ''copia'' nella Funzione chiamata.		Con il passaggio per ''Valore'' viene effettuata una ''copia'' della variabile passata alla Funzione chiamata come argomento della routine principale chiamante. Inoltre, le modifiche alla variabile del parametro passato, effettuate nella Funzione chiamata, restano confinate nell'ambito locale di detta Funzione secondaria. Ciò significa che la variabile, passata come parametro dalla routine chiamante a quella chiamata, non vede modificarsi il suo valore, nonostante la sua copia abbia subito una modifica del proprio valore a seguito di una o più operazioni nella Funzione secondaria chiamata. La viariabile presente nella routine principale chiamante resta intatta, immodificata, qualunque cosa avvenga alla sua ''copia'' nella Funzione chiamata.