Gruppo Maps↵
Abstract
Questo gruppo contiene funzioni per la creazione e la manipolazione di strutture di dati 'a mappa' (noti anche come oggetti dizionario, coppie chiave-valore o array associative). Si possono assegnare valori a determinate chiavi. L'ordine delle coppie chiave-valore nell'oggetto mappa non è rilevante.
from_json↵
Carica una stringa formattata JSON
Sintassi:
from_json(string)
Argomenti:
- string stringa json
Esempi:
hstore_to_map↵
Crea una mappa da una stringa formattata in hstore
Sintassi:
- hstore_to_map(string)
Argomenti:
- string una stringa
Esempi:
json_to_map↵
Crea una mappa da una stringa formattata con json
Sintassi:
- json_to_map(string)
Argomenti:
- string una stringa json
Esempi:
nota bene:
Funzione eliminata a partire da QGIS 3.18
https://github.com/qgis/QGIS/pull/42179
map↵
Restituisce una mappa con tutte le chiavi ed i valori passati come coppie di parametri.
Sintassi:
map(key1, value1, key2, value2 , …_)
Argomenti:
- key una chiave (stringa)
- value un valore
Esempi:
↵
Altri esempi:
Definisco una map con:
- chiave Area_Ha -- Area in Ettari
- valore $area/10000
- chiave Perimetro_km -- Perimetro in km
- valore $perimeter/1000
map_akeys↵
Restituisce tutte le chiavi di una mappa come un array.
Sintassi:
- map_akeys(map)
Argomenti:
- map una mappa
Esempi:
Altri esempi:
Compositore di stampe↵
akeys utilizzabile in ambito compositore stampe per conoscere tutte le variabili disponibili per ogni Mappa inserita:
risultato della espressione:
_project_transform_context
item_id
item_uuid
layer_ids
layers
layout_dpi
layout_name
layout_numpages
layout_page
layout_pageheight
layout_pageoffsets
layout_pagewidth
logo_osgeo4w
map_crs
map_crs_acronym
map_crs_definition
map_crs_description
map_crs_ellipsoid
map_crs_proj4
map_crs_projection
map_crs_wkt
map_end_time
map_extent
map_extent_center
map_extent_height
map_extent_width
map_id
map_interval
map_layer_ids
map_layers
map_rotation
map_scale
map_start_time
map_units
project_abstract
project_area_units
project_author
project_basename
project_creation_date
project_crs
project_crs_acronym
project_crs_definition
project_crs_description
project_crs_ellipsoid
project_crs_proj4
project_crs_wkt
project_distance_units
project_ellipsoid
project_filename
project_folder
project_home
project_identifier
project_keywords
project_last_saved
project_path
project_title
project_units
qgis_locale
qgis_os_name
qgis_platform
qgis_release_name
qgis_short_version
qgis_version
qgis_version_no
user_account_name
user_full_name
map_avals↵
Restituisce tutti valori di una mappa come un array.
Sintassi:
- map_avals(map)
Argomenti:
- map una mappa
Esempi:
--
map_concat↵
Restituisce una mappa con tutte le entità della mappe fornite. Se due mappe contengono la stessa chiave, viene restituito il valore della seconda mappa.
Sintassi:
map_concat(__map1, _map2, …_)
Argomenti:
- map una mappa
Esempi:
map_concat(map('1','one', '2','overridden'),map('2','two', '3','three')) → map: 1: 'one, 2: 'two', 3: 'three'
--
map_delete↵
Restituisce una mappa con il valore della corrispondente chiave passata rimosso.
Sintassi:
map_delete(map, key)
Argomenti:
- map una mappa
- key la chiave da rimuovere
Esempi:
map_exist↵
Restituisce vero se la chiave passata esiste in mappa.
Sintassi:
map_exist(map, key)
Argomenti:
- map una mappa
- key chiave da cercare
Esempi:
map_get↵
Restituisce il valore di una mappa, passando la sua chiave.
Sintassi:
map_get(map, key)
Argomenti:
- map una mappa
- key chiave da cercare
Esempi:
Altri esempi:
map_get(
map_concat(map('Area_Ha',$area/10000,'Perimetro_km',$perimeter/1000)),
map(Proprietario','Pippo','CF','FNDCCCDDDEEEFFF'),'CF') → 'FNDCCCDDDEEEFFF'
Compositore di stampe↵
Nuova funzione item_variables presente, nel gruppo Layout, solo se utilizzate all'interno di un contesto di composizione.
La funzione accetta un singolo argomento, l'id per un elemento all'interno della composizione e restituisce una mappa del nome della variabile sul valore per quell'elemento. Questo ti permette di fare cose come inserire il testo in un'etichetta che recuperi le proprietà di un altro elemento nella composizione, ad es:
Inserisci la scala della mappa (Mappa 1) in un'etichetta:
Inserisci la coordinata x del centro della mappa (Mappa 1) in un'etichetta:
map_insert↵
Restituisce una mappa con una chiave/valore aggiunto. Se la chiave esiste già, il suo valore verrà sovrascritto.
Sintassi:
- map_insert(map, key, value)
Argomenti:
- map una mappa
- key la chiave da aggiungere
- value il valore da aggiungere
Esempi:
map_prefix_keys↵
Restituisce una mappa con tutte le chiavi precedute da una data stringa.
Sintassi:
- map_prefix_keys(map, prefix)
Argomenti:
- map una mappa
- prefix una stringa
Esempi:
map_to_hstore↵
Unisci gli elementi della mappa in una stringa formattata in hstore.
Sintassi:
- map_to_hstore(map)
Argomenti:
- map una mappa
Esempi:
map_to_json↵
Unisci gli elementi della mappa in una stringa formattata con json.
Sintassi:
- map_to_json(map)
Argomenti:
- map una mappa
Esempi:
nota bene:
Funzione eliminata a partire da QGIS 3.18
https://github.com/qgis/QGIS/pull/42179
to_json↵
Creare una stringa in formato JSON da una mappa, array o altro valore.
Sintassi:
- to_json(value)
Argomenti:
- value valore di input
Esempi:
url_encode↵
Restituisce una stringa codificata come URL da una mappa. Trasforma tutti i caratteri nella loro forma correttamente codificata producendo una stringa di query completamente conforme. Nota che il segno più '+' non viene convertito.
Sintassi:
- url_encode(map)
Argomenti:
- map una mappa
Esempi:
url_encode(map('a&+b', 'a and plus b', 'a=b', 'a equals b')) → 'a%26+b=a%20and%20plus%20b&a%3Db=a%20equals%20b'
