Aggiunta di commenti al codice

Quando si scrive del codice è buona prassi aggiungere dei commenti che descrivono il codice. I commenti consentono agli altri di capire il codice e possono rinfrescare la memoria quando si torna ad esaminarlo in un secondo momento. Durante lo sviluppo e il test del codice, è inoltre possibile utilizzare i commenti per convertire in commento qualsiasi parte di codice che non deve essere eseguita.

Nel Live Editor è possibile inserire righe di testo prima e dopo il codice per descrivere un processo o un codice. Le righe di testo offrono una maggiore flessibilità, come le opzioni di formattazione standard e l'inserimento di immagini, collegamenti ipertestuali ed equazioni. Per maggiori informazioni, vedere Create Live Scripts in the Live Editor.

Aggiunta di commenti

Per aggiungere commenti al codice MATLAB®, utilizzare il simbolo percentuale (%). Le righe di commento possono apparire in qualsiasi punto di un file di codice ed è possibile aggiungere commenti alla fine di una riga di codice.

Ad esempio:

% Add up all the vector elements.
y = sum(x)           % Use the sum function.

Conversione in commento del codice

Per convertire in commento più righe di codice, utilizzare gli operatori di commento del blocco %{ e %}. Gli operatori %{ e %} devono apparire da soli sulle righe che precedono e seguono immediatamente il blocco di testo guida. Non includere altro testo su queste righe.

Ad esempio:

a = magic(3);
%{
sum(a)
diag(a)
sum(diag(a))
%}
sum(diag(fliplr(a)))

Per convertire in commento una selezione, selezionare le righe di codice, andare alla scheda Editor o Live Editor e nella sezione Code fare clic sul pulsante Comment (commento) . È anche possibile digitare CTRL+R. Per rimuovere il commento dalle righe di codice selezionate, fare clic sul pulsante Uncomment (Rimuovi commento) oppure digitare CTRL+MAIUSC+R. Sui sistemi macOS, utilizzare Comando+/ per commentare e Comando+Opzione+/ per rimuovere il commento. Sui sistemi Linux®, utilizzare Ctrl+/ per commentare e Ctrl+Shift+/ per rimuovere il commento.

Per rimuovere il commento da una parte di una dichiarazione che si estende su più righe, utilizzare un'ellissi (...) anziché il segno percentuale. Ad esempio:

header = ['Last Name, ',      ...
          'First Name, ',     ...
      ... 'Middle Initial, ', ...
          'Title']

Ritorno a capo dei commenti

Per impostazione predefinita, durante la digitazione dei commenti nell'Editor e nel Live Editor, il testo va a capo automaticamente quando raggiunge una larghezza della colonna di 75. L’Editor e il Live Editor non vanno a capo nei commenti con:

  • Titoli delle sezioni (commenti che iniziano con %%)

  • Testo lungo e continuo, come gli URL

  • Voci di elenchi puntati (testo che inizia con * o #) sulla riga precedente

Per modificare il punto in cui il testo del commento va a capo o per disabilitare il ritorno a capo automatico, andare alla scheda Home e nella sezione Environment, fare clic su Settings. Selezionare MATLAB > Editor/Debugger > MATLAB Language e regolare le impostazioni Comment formatting.

Prima di R2025a: Selezionare invece MATLAB > Editor/Debugger > Language.

Se sono presenti dei commenti che superano la larghezza attuale della colonna, per fare in modo che vadano a capo automaticamente, andare alla scheda Editor o Live Editor e nella sezione Code, fare clic sul pulsante Wrap comments (Ritorno a capo dei commenti) . Ad esempio, si supponga di avere questo lungo testo in una riga commentata.

% This is a code file that has a comment that is a little more than 75 columns wide.
disp('Hello, world')
Mantenendo il cursore sulla riga, andare alla scheda Editor o Live Editor e nella sezione Code, fare clic sul pulsante Wrap comments (Ritorno a capo dei commenti) . Il commento va a capo nella riga successiva:
% This is a code file that has a comment that is a little more than 75
% columns wide.
disp('Hello, world')

Controllo ortografico nei commenti

È possibile verificare la presenza di errori ortografici nei commenti. Per abilitare il controllo ortografico, andare alla scheda View e fare clic sul pulsante Spelling per attivarlo. Le parole che presentano un potenziale problema ortografico sono sottolineate in blu. Per risolvere il problema, fare clic sulla parola e selezionare una delle correzioni proposte. È inoltre possibile scegliere di ignorare il problema o aggiungere la parola contrassegnata al dizionario locale. Per navigare tra i problemi tramite tastiera, utilizzare ALT+F7 e ALT+MAIUSC+F7.

Il controllo ortografico è supportato in inglese americano per i file di codice MATLAB e i file di codice live (.m e .mlx). Per rimuovere parole dal dizionario locale, andare alla cartella delle impostazioni di MATLAB (la cartella restituita quando si esegue prefdir) e modificare il file dict/en_US_userDictionary.tdi.

Vedi anche

Argomenti

Siti web esterni