summaryrefslogtreecommitdiffhomepage
path: root/it-it/toml-it.html.markdown
blob: 99082048145654dc418d09d3139e56af34a7e9a3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
---
language: toml
filename: learntoml-it.toml
contributors:
  - ["Alois de Gouvello", "https://github.com/aloisdg"]
translators:
  - ["Christian Grasso", "https://grasso.io"]
lang: it-it
---

TOML è l'acronimo di _Tom's Obvious, Minimal Language_. È un linguaggio per la
serializzazione di dati, progettato per i file di configurazione.

È un'alternativa a linguaggi come YAML e JSON, che punta ad essere più leggibile
per le persone. Allo stesso tempo, TOML può essere utilizzato in modo abbastanza
semplice nella maggior parte dei linguaggi di programmazione, in quanto è
progettato per essere tradotto senza ambiguità in una hash table.

Tieni presente che TOML è ancora in fase di sviluppo, e la sua specifica non è
ancora stabile. Questo documento utilizza TOML 0.4.0.

```toml
# I commenti in TOML sono fatti così.

################
# TIPI SCALARI #
################

# Il nostro oggetto root (corrispondente all'intero documento) sarà una mappa,
# anche chiamata dizionario, hash o oggetto in altri linguaggi.

# La key, il simbolo di uguale e il valore devono trovarsi sulla stessa riga,
# eccetto per alcuni tipi di valori.
key = "value"
stringa = "ciao"
numero = 42
float = 3.14
boolean = true
data = 1979-05-27T07:32:00-08:00
notazScientifica = 1e+12
"puoi utilizzare le virgolette per la key" = true # Puoi usare " oppure '
"la key può contenere" = "lettere, numeri, underscore e trattini"

############
# Stringhe #
############

# Le stringhe possono contenere solo caratteri UTF-8 validi.
# Possiamo effettuare l'escape dei caratteri, e alcuni hanno delle sequenze
# di escape compatte. Ad esempio, \t corrisponde al TAB.
stringaSemplice = "Racchiusa tra virgolette. \"Usa il backslash per l'escape\"."

stringaMultiriga = """
Racchiusa da tre virgolette doppie all'inizio e
alla fine - consente di andare a capo."""

stringaLiteral = 'Virgolette singole. Non consente di effettuare escape.'

stringaMultirigaLiteral = '''
Racchiusa da tre virgolette singole all'inizio e
alla fine - consente di andare a capo.
Anche in questo caso non si può fare escape.
Il primo ritorno a capo viene eliminato.
   Tutti gli altri spazi aggiuntivi
   vengono mantenuti.
'''

# Per i dati binari è consigliabile utilizzare Base64 e
# gestirli manualmente dall'applicazione.

##########
# Interi #
##########

## Gli interi possono avere o meno un segno (+, -).
## Non si possono inserire zero superflui all'inizio.
## Non è possibile inoltre utilizzare valori numerici
## non rappresentabili con una sequenza di cifre.
int1 = +42
int2 = 0
int3 = -21

## Puoi utilizzare gli underscore per migliorare la leggibilità.
## Fai attenzione a non inserirne due di seguito.
int4 = 5_349_221
int5 = 1_2_3_4_5     # VALIDO, ma da evitare

#########
# Float #
#########

# I float permettono di rappresentare numeri decimali.
flt1 = 3.1415
flt2 = -5e6
flt3 = 6.626E-34

###########
# Boolean #
###########

# I valori boolean (true/false) devono essere scritti in minuscolo.
bool1 = true
bool2 = false

############
# Data/ora #
############

data1 = 1979-05-27T07:32:00Z # Specifica RFC 3339/ISO 8601 (UTC)
data2 = 1979-05-26T15:32:00+08:00 # RFC 3339/ISO 8601 con offset

######################
# TIPI DI COLLECTION #
######################

#########
# Array #
#########

array1 = [ 1, 2, 3 ]
array2 = [ "Le", "virgole", "sono", "delimitatori" ]
array3 = [ "Non", "unire", "tipi", "diversi" ]
array4 = [ "tutte", 'le stringhe', """hanno lo stesso""", '''tipo''' ]
array5 = [
  "Gli spazi vuoti", "sono", "ignorati"
]

###########
# Tabelle #
###########

# Le tabelle (o hash table o dizionari) sono collection di coppie key/value.
# Iniziano con un nome tra parentesi quadre su una linea separata. 
# Le tabelle vuote (senza alcun valore) sono valide.
[tabella]

# Tutti i valori che si trovano sotto il nome della tabella
# appartengono alla tabella stessa (finchè non ne viene creata un'altra).
# L'ordine di questi valori non è garantito.
[tabella-1]
key1 = "una stringa"
key2 = 123

[tabella-2]
key1 = "un'altra stringa"
key2 = 456

# Utilizzando i punti è possibile creare delle sottotabelle.
# Ogni parte suddivisa dai punti segue le regole delle key per il nome.
[tabella-3."sotto.tabella"]
key1 = "prova"

# Ecco l'equivalente JSON della tabella precedente:
# { "tabella-3": { "sotto.tabella": { "key1": "prova" } } }

# Gli spazi non vengono considerati, ma è consigliabile
# evitare di usare spazi superflui.
[a.b.c]            # consigliato
[ d.e.f ]          # identico a [d.e.f]

# Non c'è bisogno di creare le tabelle superiori per creare una sottotabella.
# [x] queste
# [x.y] non
# [x.y.z] servono
[x.y.z.w] # per creare questa tabella

# Se non è stata già creata prima, puoi anche creare
# una tabella superiore più avanti.
[a.b]
c = 1

[a]
d = 2

# Non puoi definire una key o una tabella più di una volta.

# ERRORE
[a]
b = 1

[a]
c = 2

# ERRORE
[a]
b = 1

[a.b]
c = 2

# I nomi delle tabelle non possono essere vuoti.
[]     # NON VALIDO
[a.]   # NON VALIDO
[a..b] # NON VALIDO
[.b]   # NON VALIDO
[.]    # NON VALIDO

##################
# Tabelle inline #
##################

tabelleInline = { racchiuseData = "{ e }", rigaSingola = true }
punto = { x = 1, y = 2 }

####################
# Array di tabelle #
####################

# Un array di tabelle può essere creato utilizzando due parentesi quadre.
# Tutte le tabelle con questo nome saranno elementi dell'array.
# Gli elementi vengono inseriti nell'ordine in cui si trovano.

[[prodotti]]
nome = "array di tabelle"
sku = 738594937
tabelleVuoteValide = true

[[prodotti]]

[[prodotti]]
nome = "un altro item"
sku = 284758393
colore = "grigio"

# Puoi anche creare array di tabelle nested. Le sottotabelle con doppie
# parentesi quadre apparterranno alla tabella più vicina sopra di esse.

[[frutta]]
  nome = "mela"

  [frutto.geometria]
    forma = "sferica"
    nota = "Sono una proprietà del frutto"

  [[frutto.colore]]
    nome = "rosso"
    nota = "Sono un oggetto di un array dentro mela"

  [[frutto.colore]]
    nome = "verde"
    nota = "Sono nello stesso array di rosso"

[[frutta]]
  nome = "banana"

  [[frutto.colore]]
    nome = "giallo"
    nota = "Anche io sono un oggetto di un array, ma dentro banana"
```

Ecco l'equivalente JSON dell'ultima tabella:

```json
{
  "frutta": [
    {
      "nome": "mela",
      "geometria": { "forma": "sferica", "nota": "..."},
      "colore": [
        { "nome": "rosso", "nota": "..." },
        { "nome": "verde", "nota": "..." }
      ]
    },
    {
      "nome": "banana",
      "colore": [
        { "nome": "giallo", "nota": "..." }
      ]
    }
  ]
}
```

### Altre risorse

+ [Repository ufficiale di TOML](https://github.com/toml-lang/toml)