Il framework di Colibri contiene alcune classi per la configurazione dell’ambiente software; una di queste, PARAMLIST, viene presentata in questo articolo.<\/p>\n
PARAM_LIST \u00e8 utilizzata per salvare e richiamare parametri di configurazione del software: ad esempio, per conservare le informazioni sull’ultima directory usata per salvare i file tif; L<\/p>\n
class AFX_EXT_CLASS PARAMLIST :public TAGS::TAG\r\n{\r\npublic:\r\n\tPARAMLIST();\r\n\t~PARAMLIST();\r\n\r\n\tSTRING Get ( STRING id );\r\n\tbool Get ( STRING id, int *v );\r\n\tbool Get ( STRING id, float *v );\r\n\tbool Get(STRING id, void *ptr, int mem_size);\r\n\tbool Get(STRING id, FILE_ITF *obj);\r\n\r\n\tSTRING Put(STRING id,STRING value);\r\n\tbool Put ( STRING id, int value );\r\n\tbool Put ( STRING id, float value );\r\n\tbool Put(STRING id, void *ptr, int mem_size);\r\n\tbool Put(STRING id, FILE_ITF *obj);\r\n\r\n\tSTRING FileSuffix();\r\n\r\n\tbool Load(STRING path);\r\n\tbool Save(STRING path);\r\n\r\n\t\/** \\brief apre la configurazione locale \r\n\t\\details La configurazione locale \u00e8 una lista di parametri usati dall'applicazione\r\n\t\r\n\t*\/\r\n\tstatic PARAMLIST *OpenUserConfig ( );\r\n\r\n\t\/** salva la configurazione locale\r\n\t*\/\r\n\tstatic bool CloseUserConfig ( );\r\n\r\n\t\/\/ pubblica sul sito ftp un file\r\n\tbool Publish(STRING fname, STRING remote_dir);\r\n\r\n\t\/\/ recupera dal sito remoto\r\n\tbool GetFtp(STRING fname, STRING remote_dir);\r\n\r\n\t__use_tag_funcs\r\n\t__use_private_struct\r\n};\r\n\r\n<\/pre>\nPARAM_LIST gestisce una lista di parametri dei seguenti tipi:<\/p>\n
STRING \u00e8 una stringa di caratteri TCHAR di lunghezza qualunque, int e float sono i tipi C \/C++ equivalenti, void *mem \u00e8 un blocco di memoria di mem_size byte;<\/p>\n
Ogni parametro \u00e8 associato ad un id univoco, usato per la lettura\/scrittura; le funzioni PARAM_LIST::Get e\u00a0PARAM_LIST::Put richiedono come primo argomento l’identificatore\u00a0 del parametro<\/p>\n
Le funzioni PARAM_LIST::Put permettono di salvare un parametro;\u00a0 In particolare notare che la funzione\u00a0<\/em><\/span><\/p>\n Put(STRING id, void *ptr, int mem_size) ;\u00a0<\/em><\/span><\/p>\n richiede oltre all’identificatore ed al puntatore alla memoria, anche le dimensioni dal leggere; il puntatore ptr pu\u00f2 essere, ad esempio, una struttura dati i cui campi contigui hanno dimensione fissa (quindi non puntatori allocati..)<\/p>\n Per recuperare il valore di un parametro usare la funzione<\/p>\n PARAM_LIST::Get<\/span><\/em><\/p>\n Se il parametro cercato non \u00e8 stato ancora memorizzato, le funzioni Get(..) rimandano un valore di default 0 per i tipi float e int, rimanda invece 0 nel caso di un parametro stringa o puntatore void *mem; in questo caso occorrer\u00e0 gestire il risultato da parte del programmatore;<\/p>\n Le classi che hanno interfaccia FILE_ITF possono essere utilizzate come parametri gestiti da PARAM_LIST; ad esempio, tutte le classi derivata da DOCUMENT posseggono questa interfaccia, quindi potranno essere usate come parametri gestibili in PARAM_LIST.<\/p>\n Il vantaggio principale in questo caso \u00e8 nel fatto che le funzioni virtuali Read e Write di queste classi sono in grado di gestire anche la revisione della classe, e questo permette di alterare nel tempo facilmente il contenuto della classe, cosa che non \u00e8 prevista per i parametri di tipo struc<\/em><\/span>.<\/p>\n La scrittura su file della classe PARAMLIST \u00e8 effettuata attraverso le funzioni<\/p>\n bool Load(STRING path); <\/span><\/em><\/p>\n bool Save(STRING path);<\/span><\/em><\/p>\n path<\/span><\/em> \u00e8 il percorso completo del file da generare\/leggere; Il salvataggio avviene automaticamente sul file precedente, se presente, senza richiesta di conferma;<\/p>\n PARAM_LIST<\/em> \u00e8 una classe d’uso generale, ed il fatto che sia derivata da TAG<\/em><\/span>\u00a0 fa\u00a0intuire che la stessa sia usata anche per salvare configurazioni all’interno di altri file (ad esempio \u00e8 usata nella classe DOCUMENT<\/span><\/em> per salvare informazioni sul trattamento di uno specifico documento).<\/p>\n\n Le configurazioni utente contengono tutte le informazioni usate da un utilizzatore del software, e sono salvate in un file non visibile dall’utente; il modo migliore per gestire i parametri utente \u00e8 quello di usare le macro\u00a0\u00a0_$user_cfg<\/span><\/em> e\u00a0_$close_user_cfg<\/em><\/span>.<\/p>\n _$user_cfg<\/span> <\/em><\/strong>accede direttamente alla PARAM_LIST di configurazione utente<\/p>\n _$<\/span><\/strong>clos<\/strong>e_user_cfg<\/span><\/strong><\/em> salva automaticamente la configurazione utente su disco;<\/p>\n Di seguito si riporta un frammento di codice che permette di estrarre e scrivere alcuni parametri utente<\/p>\n Nel frammento di codice sono riportate due funzioni che ricevono la struttura nascosta di una classe; nella struttura sono presenti due campi int\u00a0img_type e int\u00a0img_pixel; la funzione Put_config<\/em><\/span> scrive i due parametri nella configurazione utente; la funzione Get_config<\/span><\/em> invece li recupera.<\/p>\n In entrambi i casi l’ultima riga contiene la macro _$close_user_cfg<\/em><\/span> che salva su disco la configurazione, nel caso sia stata modificata, altrimenti non fa nulla;<\/p>\n La classe pu\u00f2 essere salvata sul sito ftp ( il sito deve essere configurato nel software) attraverso le due funzioni<\/p>\n bool Publish(STRING fname, STRING remote_dir);<\/p>\n bool GetFtp(STRING fname, STRING remote_dir);<\/p>\n Publish salva su un file remoto (fname nella directory\u00a0remote_dir);\u00a0 GetFtp richiama il contenuto della classe dal file fname; Le due funzioni possono quindi essere usate per condividere parametri da parte di utenze residenti non sulla stessa rete locale.<\/p>\n Attualmente le due funzioni sono usate per trasferire messaggi fra utenti diversi registrati ed abilitati a ricevere messaggi e oggetti (file, ed altri dati) da altri utenti non necessariamente residenti sulla stessa rete.<\/p>\n <\/p>\n <\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" Il framework di Colibri contiene alcune classi per la configurazione dell’ambiente software; una di queste, PARAMLIST, viene presentata in questo articolo. PARAM_LIST \u00e8 utilizzata per salvare e richiamare parametri di configurazione del software: ad esempio, per conservare le informazioni sull’ultima directory usata…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"aside","meta":{"_acf_changed":false,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"footnotes":"","_jetpack_memberships_contains_paid_content":false,"jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":true,"jetpack_social_options":{"image_generator_settings":{"template":"highway","enabled":false},"version":2}},"categories":[2,19],"tags":[],"jetpack_publicize_connections":[],"acf":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p9rwsf-Wh","jetpack_likes_enabled":true,"jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/posts\/3613"}],"collection":[{"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/comments?post=3613"}],"version-history":[{"count":14,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/posts\/3613\/revisions"}],"predecessor-version":[{"id":3627,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/posts\/3613\/revisions\/3627"}],"wp:attachment":[{"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/media?parent=3613"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/categories?post=3613"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.colorwave.it\/blog\/wp-json\/wp\/v2\/tags?post=3613"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Leggere un parametro<\/h4>\n
Leggere\/Salvare un parametro con interfaccia FILE_ITF<\/h4>\n
Salvataggio e scrittura su file<\/h4>\n
static void put_config(CLASS_STR)\r\n{\r\n\t_$user_cfg->Put(p_img_output, _$str->img_type);\r\n\t_$user_cfg->Put(p_imap_pixels, _$str->img_pixel);\r\n\t_$close_user_cfg\r\n}\r\n\r\nstatic void get_config(CLASS_STR)\r\n{\r\n\t_$user_cfg->Get(p_img_output, &_$str->img_type);\r\n\t_$user_cfg->Get(p_imap_pixels, &_$str->img_pixel);\r\n\t_$close_user_cfg\r\n}\r\n<\/pre>\n