Co oznacza XXX w komentarzu? [Zamknięte]

71

Co ludzie zazwyczaj oznaczają, gdy widzisz XXXw komentarzu. Czasami zobaczę taki komentarz:

# XXX - This widget really should frobulate the whatsit

Oczywiście mogę powiedzieć, co oznacza komentarz, ale co ogólnie oznacza XXX? Czy to mówi „To jest hack”, a może „Może powinniśmy wrócić do tego później”? A może mówi coś zupełnie innego?

Jason Baker
źródło
3
Istnieje wiele odniesień, na które można odpowiedzieć na to pytanie: catb.org/jargon/html/X/XXX.html ; oracle.com/technetwork/java/javase/documentation/… ; c2.com/cgi/wiki?FixmeComment
pkh
Używam qazosobiście. Łatwy do pisania i po 40 latach kodowania nigdy nie pojawił się naturalnie w moim kodzie, więc mogę go łatwo wyszukać. Zamiast FixMe: lub ToDo: używam go do szybkich eksperymentalnych hacków, które mogę łatwo odwrócić, jeśli się nie uda. Ale moja qazbędzie nigdy być zobowiązani do źródła sterowania, natomiast FIXME: czy zrobienia: lub XXX może być.
Mawg
Zauważyłem, że w bazie kodów Meteora jest wiele starych komentarzy XXX ... coś w rodzaju ciągłego komentarza na temat brudnych sekretów. I wygląda na to, że używają jakiegoś narzędzia, aby automatycznie usunąć je z kodu, który jest wysyłany!
Andy

Odpowiedzi:

68

To XXX, co reprezentuje, zależy od autora kodu. Zasadniczo jest używany jako znacznik kodu, który wymaga uwagi.

Jednak ta strona internetowa przedstawia nieco inny tok myślenia:

XXX: używane do oznaczania czegoś, co jest fałszywe, ale działa

FIXME: służy do oznaczania czegoś fałszywego i zepsutego

Myślę, że to dalej pokazuje, że jego znaczenie nie jest dobrze zdefiniowane i jest używane inaczej.

Jonathan Khoo
źródło
12
HACKbyłoby alternatywą dla XXX.
Richard
1
link jest zepsuty :(
Jack
1
FIXME: link broken
onewhaleid
1
HACK nie jest alternatywą dla XXX. Flaga komentarza XXX ma długą historię i zasadniczo oznacza coś, co działa, ale wymaga uwagi (fałszywe, ale działa).
Brill Pappin
98

To brudny kawałek kodu;)

MattyD
źródło
20
Czy to jest zabawna odpowiedź, czy śmieszna i poprawna odpowiedź?
koenmetsu
4
och, ci niegrzeczni programiści
aeracode
@koenmetsu zabawne i dokładne. To źle , ale na razie działa wystarczająco dobrze, więc nie do końca źle. „Brudny” jest trafnym opisem czegoś, co działa, ale nie jest całkowicie poprawne (tj. Czyste).
Iiridayn
21

Według Wikipedii : „XXX, aby ostrzec innych programistów przed problematycznym lub mylącym kodem”. - które można wyciągnąć z pojemników z trucizną, na których jest napisane „xxx”; super stara szkoła.

Jeśli jest to notatka do zrobienia, oto pokrewny post na blogu o nazwie TODO lub nie TODO , który obejmuje użycie GREP do sortowania komentarzy według daty, właściciela itp.

błędy
źródło
13

To nic nie znaczy. Jest to po prostu ciąg znaków, który jest wizualnie charakterystyczny (co ułatwia skanowanie pod kątem wizualnym) i raczej nie pojawia się ani w kodzie ani w komentarzach (co ułatwia wyszukiwanie programowe).

Jest więc używany jako znacznik do oznaczania komentarzy, które muszą być łatwe do przeszukiwania. Zazwyczaj oznacza fragment kodu, który należy ponownie odwiedzić.

Jörg W Mittag
źródło
2
Łatwe do znalezienia także z grepem lub podobnym
Zachary K
7

IIRC to adnotacja, która poprzedza i ma podobne znaczenie do adnotacji TODO lub FIXME. Na przykład jest to dość powszechne w źródle vima.

Rein Henrichs
źródło
6

Najprawdopodobniej jest to sekwencja znaków, która nie występuje w zwykłym kodzie, co oznacza, że ​​można ją łatwo przeszukiwać z poziomu wiersza poleceń:

ravn:tmp ravn$ echo XXXX This is very bad > processor.c
ravn:tmp ravn$ echo XXXX Verify defaults before going in production > main.c
ravn:tmp ravn$ grep -R XXXX .
./main.c:XXXX Verify defaults before going in production
./processor.c:XXXX This is very bad
ravn:tmp ravn$ 

(przykład dotyczy Uniksa, uważam, że „findstr” robi to samo w systemie Microsoft Windows)


źródło
4

ale co ogólnie oznacza XXX? Czy to mówi „To jest hack”, a może „Może powinniśmy wrócić do tego później”? A może mówi coś zupełnie innego?

Dowolne z powyższych.

Wybór XXX kontra TODO, FIXME lub HACK lub coś innego nie podlega żadnym silnym regułom ani konwencjom. Zasadniczo oznacza to wszystko, co osoba, która go tam umieściła, miała na myśli. Może to być oczywiste ... lub może być całkowicie nieprzejrzyste.


AKTUALIZACJA Wikipedia obecnie (30.03.2016) mówi:

Takie tagi różnią się znacznie, ale mogą obejmować:

  • ...
  • XXX - ostrzegaj innych programistów o problematycznym lub mylącym kodzie

Zwróć uwagę na wyraźne zastrzeżenia w oryginalnym tekście. XXX można interpretować jako aluzję do „XXX”, który można zobaczyć na butelkach z trucizną i / lub bimbru w klasycznych komiksach, kreskówkach itp.

Stephen C.
źródło
2

Najprawdopodobniej jest to marker, który można później znaleźć. W przeciwieństwie do TODO, FIXME lub podobnych, XXX jest bardzo rzadko spotykany w żadnym słowie lub konstrukcji, dlatego idealnie nadaje się do markera, który będzie samodzielny podczas przeszukiwania plików.

Wieża
źródło
0

Tam, skąd pochodzę, używamy XXX (a następnie YYY, ZZZ) dla liczb, których jeszcze nie znamy, na przykład: dodaj XXX do YYY, aby znaleźć wynik, a następnie dodaj 10%.

Pochodzi z równań w szkole, gdzie „x” jest nieznaną zmienną.

Dimitrios Mistriotis
źródło