Quando un commento viene commentato, diciamo semplicemente che è "commentato". Ma quando non è commentato, che cos'è?Terminologia per il contrario del commento
Non identificato non è uguale. Attivo? Non è assolutamente commentato.
Qual è il modo migliore per fare riferimento all'atto di eliminare il commento del codice?
ho finito per andare con il codice commentato essendo codice sotto commento e codice normale essendo codice non in commento. L'azione è prendere il codice da sotto il commento o estrarre da sotto il commento.
io chiamo il codice che non è "commentata" semplicemente "codice"
Ma il codice non include i commenti? –
Certo, ma il codice con commenti non è la stessa cosa di "codice commentato". Secondo me lo stato "predefinito" è "codice" - dopo averlo commentato diventa "codice commentato" – DarkSquid
Sono d'accordo, è il codice. Il codice non include commenti. Ecco perché chiami il codice con commenti "codice commentato". Perché i commenti e il codice sono cose diverse. Il codice genera istruzioni che il computer può eseguire, i commenti non possono. –
commentata è la parola più comune per questo.
+1 Inoltre, nei popolari IDE i verbi per commentare e l'opposto, di solito sono indicati come "Commento" e "Decommentazione", quindi aggiungi un tempo passato a questi e ottieni "commentato" e "non commentato". – maxwellb
È solo un pezzo di codice non commentato, non disattivato, non cancellato, non disattivato, non inutilizzato, non deprecato, non obsoleto, non riscritto, non archiviato.
Oppure, in parole semplici, codice.
Un paio di possibilità:
+1 Stavo per provare a usare "codice live", mi sembra naturale. Anche se sono sorpreso che sia in una lista con 'codice legacy' - cosa ?! Il non commesso è live, ma come implica l'eredità? A parte "tutto è ereditario una volta scritto". ;) Scusa forse non sono un madrelingua. – n611x007
Pensate a un documento editoriale. È come dire "che cos'è la scrittura non cancellata?" Solo, la scrittura.
Visual Studio ha una funzione denominata "Commenta le righe selezionate".
La funzione opposta è denominata "Smentire le righe selezionate". Uso il termine "non commentato".
Supponendo che MS e Visual Studio siano "autorità di codice" :) – Inisheer
Risposta migliore poiché include un'origine :) –
Sebbene sia ampiamente utilizzato per fare riferimento al codice "live", "codice non elaborato" è un termine ambiguo. Potrebbe riferirsi a un codice che una volta era stato commentato, ma è stato modificato per consentirne l'esecuzione, oppure potrebbe riferirsi a un codice che non ha commenti descrittivi.
Io chiamo codice commentato ... codice scadente. Se deve essere commentato, basta buttarlo tutto insieme. Il tuo sistema di controllo della versione dovrebbe tenere traccia dei vari stati del tuo lavoro precedente. Piuttosto che commentare per gli altri per capire perché è stato commentato in seguito non sembra essere una buona pratica di codifica!
In un certo senso, sono d'accordo con te, l'eccezione che viene in mente è quella di commentare le cose durante il debug. –
Quindi "il codice non necessariamente povero" sarebbe l'altra roba? :-) – Nosredna
Vorrei che fosse "privo di commento".
Io uso "revived" o "ripristinato" per il codice che prima era commentato, ma non lo è più. Uso "live" o "uncommented" per codice che deve essere compilato o eseguito.
Vedendo quante risposte disparate esistono per questa domanda, ci sono alcune cose che dovresti fare.
Scegli un termine e bastone con esso.
La coerenza è la cosa più importante. Va bene se non è il migliore di sempre, e puoi cambiare la tua scelta se un termine più ovvio appare in un lontano futuro.
Descrivere esplicitamente questo termine con i compagni di squadra.
Non dire semplicemente "significa non commentato, o come lo chiami". Non dire semplicemente "è l'opposto del commento". Dite loro che significa codice precedentemente commentato e che ora ha rimosso la sintassi dei commenti. Dite loro che questo codice è ora attivo e verrà eseguito quando chiamato. Non dare mai per scontato che la tua squadra sia abbastanza intelligente da "prendertela" solo perché annuisce quando usi il termine.
come una risposta soggettiva, uso il termine commentata. È un brutto nome per il comportamento, ma almeno è leggermente intuitivo. Batte le sciocchezze come unhashed per le lingue che utilizzano il carattere # per i commenti.
Sinceramente dico "commentato". In frasi come "bene, funziona con quella linea commentata, quindi commentiamo e ri-eseguiamo il test". "Uncomment" sarebbe più corretto, ma sembra più clunkier. Non userei quella espressione nella scrittura formale, però, solo quando parlo con la mia coppia.
Durante una sessione di debug, ho spesso commentato e decommentato le righe di codice.
Da una prospettiva puramente semantica (e sì, anormalmente pedante), è l'azione descritta dalla frase, non dal codice.
"Commented Out" è un verbo che descrive l'azione in base alla quale una dichiarazione è stata trasformata in un commento per rimuoverlo dal codice su cui agisce il parser della lingua.
Il codice è stato sottoposto all'azione opposta, quella di prendere un commento e trasformarlo in una dichiarazione per includerlo nel codice su cui agisce il parser della lingua, sarebbe "Statemented In". Ma ovviamente è ridicolo.
Detto questo, sono d'accordo con Andrew sul fatto che al di fuori di una sessione di debug dei transienti, prima che venga eseguito il commit, il codice deve essere rimosso se non viene utilizzato e non lasciato nei commenti per confondere le cose.
Il problema è con il termine "commentato". È un abuso della funzione di commento della maggior parte delle lingue. In C/C++ si dovrebbe usare il preprocessore per la compilazione condizionale il codice, forse simile al seguente:
#if 0
...
... here is the code that is not in the build
..
#endif
...
... here is the code that is in the build
...
Ricordo uno standard di codifica in un luogo che ho usato per lavorare a utilizzare "#ifdef NOT_DEF" e pochi altri simboli al posto di "#if 0" per aggiungere qualche semantica al blocco "commentato".
I termini utilizzati in questo schema erano codice "incluso" e "escluso", anche se "incluso" veniva solitamente assunto quando si parla generalmente di "codice".
Naturalmente, non tutte le lingue moderne hanno una funzione di pre-elaborazione, quindi si torna ad abusare della funzione di commento.
Cerco di evitare di utilizzare la compilazione condizionale, dal momento che è possibile introdurre errori poiché il codice che si sta compilando non è lo stesso. Una scommessa migliore è definire una macro in fase di compilazione che stai eseguendo il debug (ad es .: gcc -DDEBUG = 1 per debug, gcc -DDEBUG = 0 per la versione) e avvolgendo il codice di debug con if (DEBUG). In questo modo si compila sempre l'intero codebase, ma non lo si usa se è presente nella build di rilascio. L'unico problema è che può far crescere l'eseguibile del rilascio poiché tutte le cose del debug sono ancora lì. –
"-DDEBUG = 1" sulla riga di comando equivale a "#define DEBUG 1" in un ambito globale. È ancora una compilazione condizionale!Nel tuo caso le sezioni di codice all'interno di un blocco if (DEBUG) non saranno compilate in build di release. –
Se una volta era commented out in passato, allora by uncommenting it diventerà
Decommented.(È possibile recomment se si vuole, ma non vi consigliamo vivamente questo ..)
Se non è mai stato mai commentata, è solo
code.Questi sono, per me ora, i diversi diversi (*) afferma che un Live code può avere. (O forse è solo Yoda inglese.)
*: Potenziale di meta- implicita [aggiungere il latin-nato termine qui: P].
E a proposito, la decomposizione sembra condividere qualche divertente discendenza comune con i dissennatori. Mentre il 'codice', in attesa di essere scelto per essere commentato, condivide quella ascendenza con il cannabis-cannibalismo di" potenziale-candidato "oh ... beh .. non importa. – n611x007
Lo chiamiamo "unremd". Non lo troverai nel dizionario, ma è l'opposto di REM (d) e, soprattutto, ha meno sillabe ...
Non corrispondente alla programmazione. –
Sono confuso. In che modo questo non è collegato alla programmazione? –
Eeek .. se i commenti non sono relativi alla programmazione, spero di non vedere mai il tuo codice. – Inisheer