{"id":3816,"date":"2019-11-26T17:33:47","date_gmt":"2019-11-26T17:33:47","guid":{"rendered":"http:\/\/www.colorwave.it\/blog\/?p=3816"},"modified":"2019-11-26T17:33:47","modified_gmt":"2019-11-26T17:33:47","slug":"le-macro-di-gestione-dei-messaggi-fra-oggetti","status":"publish","type":"post","link":"https:\/\/www.colorwave.it\/blog\/widgets\/messages\/le-macro-di-gestione-dei-messaggi-fra-oggetti\/admin\/2019\/11\/","title":{"rendered":"Le macro di gestione dei messaggi fra oggetti"},"content":{"rendered":"

Nell’articolo precedente, relativo alla classe CLB_messenger,<\/a> si sono discusse le funzionalit\u00e0 di trasmissione\/ricezione dei messaggi fra oggetti costruiti con il framework di Colibr\u00ec. In particolare \u00e8 stata analizzata la classe di servizio\u00a0 test_request\u00a0<\/em><\/a> utilizzata per la formattazione e il parsing<\/a> dei comandi scambiati.<\/p>\n

In questo articolo presenteremo in modo sintetico le macro che semplificano e rendono pi\u00f9 leggibile la scrittura del codice, senza la necessit\u00e0 di usare le funzioni, a volte complesse, che abbiamo descritto\u00a0 nel precedente articolo.<\/p>\n

L’insieme delle macro qui descritte\u00a0 costituisce un sottoinsieme dei comandi che possono essere scritti nel linguaggio di Colibri. Le definizioni relative sono scritte in un insieme di file di inclusione, disponibili\u00a0 attraverso la linea<\/p>\n

#include \"WIDGET_DEFINITION.h\"\r\n<\/pre>\n
Comandi, messaggi, parametri..\u00a0<\/strong><\/h4>\n
Le macro che verranno descritte, fanno parte del linguaggio di Colibri (CLB_lang<\/em><\/span>, come definito di seguito) , e consistono in metodi e funzioni<\/i>, nell’accezione di un linguaggio come c \/c++; Nel nostro caso, per comodit\u00e0 parleremo di comandi <\/strong>quando faremo riferimento alle macro di CLB_lang, parleremo di messaggi<\/strong> quando definiremo la frase che viene scambiata fra gli oggetti usando\u00a0 le macro relative di CLB_lang; ad esempio:<\/p>\n
#define __send_cmd_to_obj(receiver,...)  send_to_obj(receiver,__VA_ARGS__,_$end)\r\n<\/pre>\n
__send_cmd_to_obj \u00e8\u00a0 un comando di CLB_lang<\/span><\/em> i cui parametri sono receiver<\/span> <\/em>ed una lista variadic<\/em> di altri elementi.<\/p>\n
Quando usiamo il comando nel codice, probabilmente scriveremo un’istruzione di questo tipo:<\/p>\n
__send_cmd_to_obj(w_plot, _$get, _$selected, _$curve, curva);<\/pre>\n
il parametro w_plot, <\/span><\/em>\u00e8 il destinatario del messaggio<\/span><\/p>\n
la sequenza di parametri _$get, _$selected, _$curve, curva\u00a0<\/span><\/em>costituisce il messaggio<\/strong> che sar\u00e0 ricevuto dalla funzione slot_messenger<\/p>\n
$get, _$selected, _$curve <\/span><\/em>\u00e8 la frase del messaggio<\/span><\/span><\/p>\n
curva\u00a0<\/span><\/em>\u00e8 il puntatore ad un oggetto passato come allegato al messaggio;<\/p>\n
la frase che compone il messaggio \u00e8 in genere formato da stringhe nella forma _$word <\/em>dove il suffisso mnemonico _$ serve ad indicare che \u00e8 una stringa appartenente a CLB_lang;\u00a0 tutti gli altri costituenti il messaggio sono parametri, come in questo esempio. Lo scopo \u00e8 quello di rendere evidente a chi legge il programma (anche chi lo scrive, magari dopo mesi, dovr\u00e0 rileggerlo..) la funzione svolta dal messaggio. ad esempio un comando come il seguente \u00e8 simile nella forma a quello sopra riportato, ma il significato \u00e8 evidentemente diverso.<\/p>\n
__send_cmd_to_obj(w_plot, _$get, _$selected, _$document, doc);<\/pre>\n
Cosa c’\u00e8 scritto nelle stringhe di tipo _$<\/span>word? un testo mnemonico che richiama la descrizione stessa: ad esempio, facendo riferimento agli elementi della frase appena descritta,<\/p>\n
#define _$get\u00a0 L\"get\"\r\n#define _$selected L\"selected\"\r\n#define _$document L\"document\"<\/pre>\n
Ma nella logica del programma$get<\/span> poteva contenere l’italiano\u00a0 “estrai”, ma non sarebbe cambiato nulla per il significato d’uso.<\/p>\n\n
__send_cmd( cmd,…)<\/strong><\/h4>\n
E’ usato per richiamare una funzione CLB_messenger::send(….) con una facilitazione: la macro send_cmd\u00a0 inserisce automaticamente _$end a fine lista, come atteso\u00a0 dalla CLB_messenger::send(..).\u00a0 Per usare la send_cmd:<\/p>\n
il messaggio \u00e8 trasmesso a tutti gli oggetti connessi\u00a0 (vedi CLB_regs(..)) ed esistono due diverse modalit\u00e0 d’uso, a seconda che si mandi il messaggio da un oggetto dato il suo putatore obj, o da una funzione della classe<\/p>\n