XXX หมายถึงอะไรในความคิดเห็น [ปิด]

72

คนทั่วไปหมายถึงอะไรเมื่อใดก็ตามที่คุณเห็นXXXในความคิดเห็น บางครั้งฉันจะเห็นความคิดเห็นเช่นนี้:

# XXX - This widget really should frobulate the whatsit

แน่นอนฉันสามารถบอกได้ว่าความคิดเห็นนั้นหมายถึงอะไร แต่ XXX โดยทั่วไปหมายถึงอะไร มันพูดว่า "นี่คือแฮ็ค" หรืออาจ "เราควรกลับมาทบทวนอีกครั้งในภายหลัง"? หรือมันจะพูดอย่างอื่นอย่างสิ้นเชิง?

comments coding-standards

— Jason Baker
แหล่งที่มา

3

มีการอ้างอิงมากมายที่จะตอบคำถามนี้: catb.org/jargon/html/X/XXX.html ; oracle.com/technetwork/java/javase/documentation/… ; c2.com/cgi/wiki?FixmeComment

— pkh

ฉันใช้qazเป็นการส่วนตัว ง่ายต่อการพิมพ์และใน 40 ปีของการเข้ารหัสมันไม่เคยเกิดขึ้นตามธรรมชาติในรหัสของฉันดังนั้นฉันสามารถค้นหาได้อย่างง่ายดาย แทนที่จะใช้ FixMe: หรือ ToDo: ฉันใช้มันเพื่อแฮ็กทดลองอย่างรวดเร็วซึ่งฉันสามารถย้อนกลับได้อย่างง่ายดายหากไม่ได้ผล แต่ฉันqazจะไม่มุ่งมั่นที่จะควบคุมแหล่งที่มาในขณะที่ FixMe: หรือ ToDo: หรือ XXX อาจเป็น

— Mawg

ฉันสังเกตุเห็นว่ามีความคิดเห็น XXX เก่า ๆ มากมายใน codebase ของ Meteor ... เป็นคำอธิบายเกี่ยวกับความลับที่สกปรก และดูเหมือนว่าพวกเขาใช้เครื่องมือบางอย่างในการตัดพวกเขาออกจากรหัสที่จัดส่งโดยอัตโนมัติ!

— Andy

68

สิ่งที่XXXเป็นตัวแทนขึ้นอยู่กับผู้เขียนของรหัส โดยทั่วไปจะใช้เป็นเครื่องหมายสำหรับรหัสที่ต้องการความสนใจ

อย่างไรก็ตามหน้าเว็บนี้กล่าวถึงแนวคิดที่แตกต่าง:

XXX: ใช้เพื่อตั้งค่าสถานะสิ่งที่เป็นของปลอม แต่ใช้งานได้

การแก้ไข: ใช้ในการตั้งค่าสถานะบางสิ่งที่ปลอมและหัก

ฉันเดาว่าสิ่งต่อไปนี้แสดงให้เห็นว่าความหมายของมันไม่ได้นิยามไว้อย่างชัดเจนและถูกนำไปใช้ต่างกัน

— โจนาธานคู
แหล่งที่มา

12

HACKXXXจะเป็นทางเลือกที่จะ

— ริชาร์ด

1

ลิงก์ใช้งานไม่ได้ :(

— แจ็ค

1

FIXME: link broken

— onewhaleid

1

HACK ไม่ใช่ทางเลือกของ XXX การตั้งค่าสถานะความคิดเห็น XXX มีประวัติอันยาวนานและเป็นหลักหมายถึงสิ่งที่ใช้งานได้ แต่ต้องการความสนใจ (ปลอม แต่ใช้งานได้)

— Brill Pappin

98

มันเป็นโค้ดที่สกปรก ;)

— MattyD
แหล่งที่มา

20

นี่เป็นคำตอบที่ตลกหรือคำตอบที่ตลกและถูกต้องหรือไม่?

— koenmetsu

4

โอ้โปรแกรมเมอร์ผู้ซุกซน

— aeracode

@koenmetsu ตลกและถูกต้อง มันผิดแต่ทำงานได้ดีพอสำหรับตอนนี้จึงไม่ผิดทั้งหมด "Dirty" เป็นคำอธิบายที่เหมาะสมสำหรับบางสิ่งที่ใช้งานได้ แต่ไม่ถูกต้องทั้งหมด (เช่นสะอาด)

— Iiridayn

21

ตามวิกิพีเดีย : "XXX เตือนผู้เขียนโปรแกรมคนอื่นถึงรหัสที่มีปัญหาหรือมีความเข้าใจผิด" - ซึ่งอาจถูกดึงออกมาจากภาชนะบรรจุสารพิษที่พูดว่า "xxx" โรงเรียนเก่าสุด

ถ้าเป็นบันทึกสิ่งที่ต้องทำนี่เป็นบล็อกโพสต์ที่เกี่ยวข้องที่เรียกว่าสิ่งที่ต้องทำหรือไม่สิ่งที่ครอบคลุมซึ่งใช้ GREP เพื่อเรียงลำดับความคิดเห็นตามวันที่เจ้าของ ฯลฯ

— ความผิดพลาด
แหล่งที่มา

13

มันไม่มีความหมายอะไรเลย มันเป็นเพียงลำดับของตัวละครที่มีความโดดเด่นทางสายตา (ซึ่งทำให้ง่ายต่อการสแกนเพื่อการมองเห็น) และไม่น่าจะปรากฏในโค้ดหรือความคิดเห็น (ซึ่งทำให้ง่ายต่อการค้นหาโดยทางโปรแกรม)

ดังนั้นจึงใช้เป็นเครื่องหมายเพื่อตั้งค่าสถานะความคิดเห็นที่ต้องการค้นหาได้ง่าย โดยปกติจะทำเครื่องหมายชิ้นส่วนของรหัสที่ต้องมีการตรวจทานอีกครั้ง

— Jörg W Mittag
แหล่งที่มา

2

หาง่ายด้วย grep หรือชอบ

— Zachary K

7

IIRC เป็นคำอธิบายประกอบที่มีมาก่อนและมีความหมายคล้ายกับคำอธิบายประกอบสิ่งที่ต้องทำหรือ FIXME มันค่อนข้างบ่อยในแหล่งที่มาเป็นกลุ่มเช่น

— Rein Henrichs
แหล่งที่มา

6

เป็นไปได้ว่าลำดับของอักขระที่ไม่เกิดขึ้นในรหัสปกติซึ่งหมายความว่าสามารถค้นหาได้ง่ายจากบรรทัดคำสั่ง:

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$

(ตัวอย่างสำหรับ Unix ฉันเชื่อว่า "findstr" ทำเช่นเดียวกันภายใต้ Microsoft Windows)

4

แต่โดยทั่วไป XXX หมายความว่าอย่างไร มันพูดว่า "นี่คือแฮ็ค" หรืออาจ "เราควรกลับมาทบทวนอีกครั้งในภายหลัง"? หรือมันจะพูดอย่างอื่นอย่างสิ้นเชิง?

ข้อใดข้อหนึ่งข้างต้น

ตัวเลือกของ XXX กับสิ่งที่ต้องทำหรือ FIXME หรือแฮ็กหรืออย่างอื่นนั้นไม่ได้อยู่ภายใต้กฎหรือระเบียบที่เข้มงวดใด ๆ โดยพื้นฐานแล้วมันหมายถึงสิ่งที่คนที่วางไว้ที่นั่นตั้งใจให้หมายถึง มันอาจจะชัดเจน ... หรือมันอาจจะทำให้คุณขุ่นเคือง

อัปเดต Wikipediaปัจจุบัน (2016-03-30) พูดว่า:

แท็กดังกล่าวแตกต่างกันอย่างกว้างขวาง แต่อาจรวมถึง:

...

XXX - เตือนโปรแกรมเมอร์คนอื่น ๆ ให้ทราบถึงรหัสที่มีปัญหาหรือทำให้เข้าใจผิด

สังเกตคำเตือนที่ชัดเจนในข้อความต้นฉบับ XXX อาจถูกตีความว่าเป็นการพูดพาดพิงถึง "XXX" ที่คุณเห็นเกี่ยวกับขวดยาพิษและ / หรือแสงจันทร์ในการ์ตูนคลาสสิกการ์ตูน ฯลฯ

— สตีเฟ่นซี
แหล่งที่มา

2

มันอาจเป็นเครื่องหมายที่สามารถพบได้ในภายหลัง แตกต่างจากสิ่งที่ต้องทำหรือ FIXME หรือเหมือนกัน XXX จะพบได้ยากมากในคำหรือสร้างใด ๆ จึงทำให้มันสมบูรณ์แบบสำหรับเครื่องหมายที่จะยืนอยู่คนเดียวเมื่อมีการค้นหาไฟล์

— โกง
แหล่งที่มา

0

ฉันมาจากที่ไหนเราใช้ XXX (และจากนั้น YYY, ZZZ) สำหรับตัวเลขที่เรายังไม่ทราบตัวอย่างเช่น: เพิ่ม XXX ลงใน YYY เพื่อค้นหาผลลัพธ์จากนั้นเพิ่ม 10%

มีต้นกำเนิดมาจากสมการที่โรงเรียนซึ่ง 'x' เป็นตัวแปรที่ไม่รู้จัก

— Dimitrios Mistriotis
แหล่งที่มา