Definizione di sintassi (linguaggi di programmazione): La sintassi di un linguaggio informatico è l'insieme di regole che definisce la combinazione di simboli considerati un documento o un frammento correttamente strutturato in quel linguaggio.

Definizione di sintassi: La disposizione di simboli e caratteri per formare espressioni o funzioni.

 

Simboli e loro nomi

I seguenti simboli sono usati per scrivere Espressioni e Funzioni.

[	Parentesi quadra aperta
]	Parentesi quadra chiusa
(	Parentesi tonda aperta
)	Parentesi tonda chiusa
"	Virgoletta, virgolette o virgola invertita
|	Barra verticale
&	E commerciale
{	Parentesi graffa aperta
}	Parentesi graffa chiusa
;	Punto e virgola
:	Due punti
#	Cancelletto

 

Quando utilizzare ciascun simbolo

Quando usare le Parentesi quadre?

Le parentesi quadre sono usate quando si fa riferimento a un Campo all'interno di un'Espressione o di una Funzione.

Esempio: Se vogliamo fare riferimento alla gara di un partecipante, lo faremmo cosí

[Gara]

Esempio: Se vogliamo confrontare la Gara di un partecipante per vedere se corrisponde a un ID di Gara specifico, dobbiamo farlo cosí

[Gara] = 1

Se il partecipante è nella gara 1, quando facciamo riferimento alla [Gara] con l'uso delle parentesi quadre, riceveremo il valore 1. Ciò valuterà l'esempio sopra come vero perché 1 equivale a 1.

 

Quando usare le Parentesi tonde?

Le parentesi tonde vengono utilizzate per contenere i parametri all'interno di una Funzione.

Esempio: Se volessimo scrivere un'istruzione if per restituire sì se un partecipante è nella gara 1, altrimenti restituire no, potremmo farlo in questo modo

​​​​​​if(​[Gara]=1;"si";"no")

Nell'esempio sopra, stiamo usando un'istruzione if tra parentesi tonde per contenere la nostra espressione.

Le parentesi sono inoltre utilizzate per definire l'ordine delle operazioni.

Esempio: se hai una gara a giri variabili con un giro iniziale di 1km e i giri seguenti di 10 km e vuoi calcolare quanti km ogni partecipante compie (includendo il giro iniziale), puoi usare le parentesi per definire l'ordine di operazioni per calcolare questo.

​​​​​(​([NumerodiGiri]-1)*10)+1

In questo modo prima calcoliamo il numero di giri da 10km fatti dal partecipante sottraendo al numero totale di giri un giro (che corrisponde al giro iniziale di 1 km); successivamente moltiplichiamo questo numero per 10 in modo tale da avere i km fatti dal partecipante ed infine sommiamo 1, rappresentante il km del giro iniziale. Se per esempio i giri totali compiuti dal partecipante sono 5, sostituendolo nella formula si avrà come risultato 41km. Questo esempio presume che il punto di cronometraggio partenza/intermedio/arrivo sia lo stesso per il giro di parata che il giro normale.

Quando usare le Parentesi graffe?

Le parentesi graffe vengono utilizzate quando si fa riferimento al valore di un Moltiplicatore di record all'interno di un Elenco.

Esempio: Se volessimo fare riferimento ai giri da 1 a 3 e i giri sono chiamati Giro1, Giro2, Giro3 nella Finestra Principale-> Risultati (Avanzati), allora potremmo farlo cosí

[Giro{n}]

Nell'esempio sopra, stiamo facendo riferimento ai giri da 1 a 3 aggiungendo il testo Giro con il valore del moltiplicatore di record che è definito tra due parentesi graffe.

Le parentesi graffe vengono anche utilizzate per tradurre stringhe in diverse lingue.

Esempio: Se vogliamo che l'esempio sopra visualizzi "Yes" o "No" quando si utilizza il software o my.raceresult.com in inglese, o "Si" o "No" per lo spagnolo, scriveremo:

​​​​​​if(​[Gara]=1;"{EN:yes|ES:si}";"no")

Si noti che il valore per le diverse lingue è separato da una barra verticale.

 

Quando usare le Virgolette?

Le virgolette vengono utilizzate per fare riferimento a una stringa di testo.

Definizione di stringa (informatica): Una stringa è tradizionalmente una sequenza di caratteri, sia come costante letterale che come una sorta di variabile.

Esempio: Se volessimo trovare tutti i partecipanti con il nome di John, allora potremmo impostare un filtro come questo

[Nome] = "John"

Nell'esempio sopra, John è tra virgolette perché il suo nome è una stringa che stiamo cercando di confrontare. Nome è tra parentesi quadre perché è un campo che restituirà un valore stringa da confrontare con la stringa John.

 

Quando usare il Punto e virgola?

I punti e virgola sono usati per separare i parametri all'interno di una Funzione.

Esempio: In un'istruzione if ci sono tre parametri. Ogni parametro deve essere separato con un punto e virgola come questo

if([Pettorale]=1;"si";"no")

Nell'esempio sopra, stiamo verificando se il pettorale è uguale a 1. Se Pettorale è uguale a 1 (vero), allora restituisce Sì altrimenti (falso) restituisce "No".

 

Quando usare la E commerciale?

Le e commerciali vengono utilizzate per aggiungere una stringa ad un'altra.

Esempio: Se vuoi aggiungere una stringa come "John" a un campo dati come [Cognome], puoi fare qualcosa del genere

"John " & [Cognome]

Nell'esempio precedente se il valore di [Cognome] è "Doe", la stringa restituita è "John Doe". Questo è anche noto come concatenare due stringhe insieme.

 

Quando usare il cancelletto?

Un cancelletto indica che l'espressione è full-text. In questo modo, non è necessario utilizzare le virgolette attorno alle stringhe di testo e le e commerciali per combinare campi, stringhe e funzioni. I campi e le funzioni devono essere racchiusi tra parentesi quadre.

Esempio: puoi ottenere lo stesso risultato sopra citato scrivendo l'espressione in questo modo:

#John [Cognome]