Đầu tiên nhận thấy điều này trong Notepad ++, trong đó //
nhận xét và ///
nhận xét được hiển thị bằng các màu khác nhau.
Doxygen tiết lộ thêm về điều đó, nhưng tôi không thuyết phục về hiệu quả của nó.
1. Tại sao mọi người sử dụng ba kiểu nhận xét cắt giảm khi dễ dàng nhập /*
và */
? (Tôi có giải thích tốt hơn là hữu ích khi lồng các chú thích)
2. Để có thể sử dụng được, trình chỉnh sửa hỗ trợ chặn nhận xét cho dấu gạch chéo ba theo cách mà Visual Studio hỗ trợ Ctrl+k Ctrl+c
cho đa bình luận?Ba dấu gạch chéo về phía trước để chặn nhận xét?
Trả lời
Trong Visual Studio ///
cho biết documentation không chỉ là nhận xét. Theo liên kết của bạn, lời giải thích là như nhau. Nó được sử dụng để tô điểm cho ý kiến mà sẽ được định dạng đặc biệt qua soạn thảo của bạn hoặc một số công cụ khác như tài liệu cho một lớp học, phương pháp namespace vv
Đây là Visual Studio ít hơn và C# cụ thể hơn. C++ trong Visual Studio rõ ràng có thể có '///' bình luận, nhưng chúng không có ý nghĩa đặc biệt, và doc-comment-viewer cũng sẽ hiển thị các chú thích '//' hoặc '/ * * /'. – ssube
Tôi vẫn chưa hiểu. Tôi muốn nhận xét, ví dụ: một chức năng như vậy, khi chuột của tôi kết thúc, nhận xét của tôi sẽ hiển thị hoặc trong menu, khi bạn có thể chọn các hàm lớp. Làm thế nào để làm điều đó? –
Hiện có bất kỳ lối tắt nào để ghi lại tài liệu không? Thật nhàm chán khi tạo 3 '/' mọi lúc. Ctrl + K tạo 2 '/', không phải là 3 .. – Arkady
- Chắc chắn, nó dễ dàng hơn để đạt cùng ba lần trọng hơn đánh hai riêng biệt phím.
- Không biết về các IDE khác, nhưng XCode4 hỗ trợ đoạn mã nơi bạn có thể nhập khá nhiều thứ. Trên Visual Studio, tôi sử dụng Visual Assist X, mang lại cho tôi điều tương tự. XCode4 Example, Visual AssistX example. Tôi phải giả định các IDE khác cung cấp chức năng tương tự.
Điều đó nói rằng, vâng tôi cũng đã gặp ba dấu gạch chéo và chúng thường được sử dụng để chỉ ra các nhận xét rằng hệ thống tự động hóa như doxygen sẽ chọn.
Visual Assist X cũng có tùy chọn mở rộng-multiline-nhận xét, được sử dụng với đoạn mã làm cho các chú thích '/ ** * * /' hầu như không có tác dụng. – ssube
Tác giả có thể có ý định đưa tài liệu sau ///
Tại nơi tôi làm việc, chúng tôi sử dụng 3 kiểu khối doxygen Viết bình luận cho tài liệu vì thiếu các hướng dẫn phong cách mã hóa.
- ///
- //!
- /** */
- 1. InetAddress.toString() trả về dấu gạch chéo về phía trước
- 2. Nếu chuỗi chứa dấu gạch chéo về phía trước
- 3. Regexp.escape không thoát khỏi dấu gạch chéo về phía trước?
- 4. Tại sao String.Format chuyển đổi dấu gạch chéo về phía trước thành dấu trừ?
- 5. Làm cách nào để lấy Path.Combine của .NET để chuyển đổi dấu gạch chéo về phía trước thành dấu gạch chéo ngược?
- 6. truy cập thuộc tính đối tượng json có chứa dấu gạch chéo về phía trước
- 7. tìm kiếm và thay thế cho dấu gạch chéo về phía trước
- 8. Solr Truy vấn không phân tích dấu gạch chéo về phía trước
- 9. Làm thế nào để thay thế dấu gạch chéo ngược với dấu gạch chéo ngược
- 10. url mã hóa phía trước dấu gạch chéo phá ứng dụng CodeIgniter tôi
- 11. Tại sao Umbraco WYSIWYG đặt dấu gạch chéo ở phía trước liên kết thẻ?
- 12. Bạn có phải thoát khỏi dấu gạch chéo ở phía trước khi sử dụng mod_rewrite không?
- 13. Do i cần một dấu gạch chéo ở phía trước đường ray tuyến đường
- 14. url với nhiều dấu gạch chéo về phía trước, nó có làm hỏng bất kỳ thứ gì không?
- 15. Cách bỏ qua tính năng Tìm kiếm nhanh của Firefox và chụp dấu gạch chéo về phía trước
- 16. Chặn nhận xét trong Ruby
- 17. Hãy dạy tôi một cách ghi nhớ tốt để ghi nhớ "dấu gạch chéo" và "dấu gạch chéo ngược"
- 18. Làm cách nào để tạo đường dẫn thư mục có dấu gạch chéo ngược hoặc dấu gạch chéo chéo?
- 19. Nhận nội dung sau dấu gạch chéo cuối cùng
- 20. Chặn nhận xét trong Gedit?
- 21. Thay thế ngược chéo với chuyển tiếp chéo hoặc dấu gạch chéo ngược đôi trong C++
- 22. Cụm từ thông dụng: Chuỗi trận đấu giữa hai dấu gạch chéo nếu chuỗi đó chứa dấu gạch chéo thoát
- 23. biểu thức chính quy và dấu gạch chéo chuyển tiếp
- 24. Sử dụng dấu gạch chéo trong window.location.hash
- 25. Làm cách nào để thay thế dấu gạch chéo ngược bằng dấu gạch chéo ngược kép bằng RegExp?
- 26. Thêm dấu gạch chéo ngược vào chuỗi
- 27. mod_rewrite: thêm dấu gạch chéo sau?
- 28. Cho phép ba/ba gạch chéo các chú thích XML trong Visual Studio 2010 cho C#
- 29. Xóa dấu gạch chéo đầu và cuối/
- 30. nginx và dấu gạch chéo trên $ document_root?
Bạn đang sử dụng Doxygen? Đây là lý do tại sao Doxygen đề xuất '///' thay vì '/ * * /' cho tài liệu mã C++. – birryree
Nó sẽ là '/ ** * /' cho tài liệu. –
Ok, vì vậy, đó là tài liệu hướng dẫn. Tôi nghĩ rằng đó là một cách thay thế/tốt hơn để thực hiện nhận xét nhiều dòng. – Nav