Commenti in Testo Strutturato (ST)

Introduzione

È possibile utilizzare i commenti nel codice per aiutare gli altri a capire l'intento del programma o della funzione. I commenti possono essere inseriti ovunque sia consentito uno spazio, tranne che all'interno di valori letterali di stringhe di caratteri. I commenti non hanno impatto sull'esecuzione del programma.

Commenti su una riga

I commenti su una riga iniziano con un doppio slash // e terminano al termine della riga. Nei commenti su una riga, le combinazioni di caratteri speciali (* e *) o /* e */ non hanno significati speciali come nei commenti multi-riga.

I commenti su una riga vengono supportati da Control FPWIN Pro7 dalla versione 7.6.0.0 in avanti. Possono causare un errore di compilatore nelle versioni obsolete di Control FPWIN Pro7.

Commenti multi-riga

I commenti multi-riga iniziano con (* e terminano con *) o con /* e terminano con */. Questo tipo di commento può andare a capo su più righe. Nei commenti multi-riga, la combinazione di caratteri speciali // non ha un significato speciale come nei commenti su una riga.

(*-------------------
* Calculate
fan speed *)

/*-------------------
* Calculate fan speed
*/

Nidificazione di commenti multi-riga

Un commento nidificato è un commento contenuto all'interno di un altro commento. I commenti possono essere nidificati se la seguente impostazione di opzione è abilitata: Altro > Opzioni > Opzioni di compilazione > Errori ulteriori > Commenti nidificati su più righe.

Con i commenti nidificati è possibile commentare rapidamente e facilmente grandi blocchi di codice, anche se il codice contiene già commenti su una o più righe.

/* This is a multi-line comment
(* this is also a multi-line comment*) /*another multi-line comment*/
This is still part of the multi-line comment */

(* Commented out code
/* Calculate fan speed */
bFan := TRUE; // Turn on the fan
*)

Commenti non corretti

(* wrong comment end characters */
/* wrong comment end characters *)

/* Incorrect comment
/* /* This should be incorrect.
*/

Uniform Resource Locator (URL) con commenti

Gli URL possono essere utilizzati nei commenti. Premere <Ctrl> e fare clic sul testo dell'URL per aprire l'URL nel proprio browser di default o applicazione per e-mail.

// sample comment https://www.google.com

// sample comment https://www.google.com/search?q=panasonic

// sample comment mailto:email@example.com

// sample comment mailto:email@example.com?cc=secondemail@example.com,anotheremail@example.com,
&bcc=lastemail@example.com&subject=Mail%20from%20our%20Website

// sample comment file://C:\filename.txt

// sample comment file://C:\foldername

// sample comment ftp://username@192.168.178.55:8000

Mostra elenco di completamento automatico con commenti

Se si desidera inserire un nome di istruzione o variabile in un commento, è possibile visualizzare il completamento automatico con la combinazione di tasti <Ctrl>+<Spazio>.