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

Da R2024a

È possibile verificare la presenza di errori ortografici nei commenti. 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 (.m), i file di codice live (.m e .mlx) e i file Markdown. 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.

Per impostazione predefinita, il controllo ortografico è attivo. Se un file contiene molte parole non riconosciute, ad esempio quando non è scritto in inglese americano, MATLAB disattiva automaticamente il controllo ortografico per quel file. Per disattivare manualmente il controllo ortografico per un file, andare alla scheda View e, nella sezione Review, disattivare il pulsante Spelling. Per disattivare il controllo ortografico per tutti i file, nella scheda Home, nella sezione Environment, fare clic su Settings (Impostazioni). Selezionare MATLAB > Editor/Debugger > Spelling e impostare Check spelling su Off. Per modificare il testo su cui eseguire il controllo ortografico, nella sezione Where to check spelling, selezionare o deselezionare le opzioni disponibili. Per maggiori informazioni, vedere Editor/Debugger Spelling Settings.

Prima di R2026a: Per impostazione predefinita, il controllo ortografico è disattivato. Per attivare il controllo ortografico, andare alla scheda View e, nella sezione Review, attivare il pulsante Spelling. Inoltre, le impostazioni ortografiche non sono disponibili e il controllo ortografico nei file Markdown non è supportato.

Vedi anche

Argomenti

Risorse didattiche