Sử dụng khối bình luận#

Using Comment Blocks

Bài hướng dẫn này sẽ trình bày cách sử dụng khối chú thích trong VEXcode GO. Sau khi hoàn thành, bạn sẽ hiểu tại sao và cách sử dụng chú thích để ghi lại nội dung dự án.

Khối Chú thích cho phép bạn thêm ghi chú trực tiếp vào nhóm các khối của mình, được tìm thấy trong danh mục Logic - Chú thích trong hộp công cụ. Chúng không ảnh hưởng đến cách dự án của bạn hoạt động — chúng chỉ có tác dụng giúp bạn và những người khác hiểu dự án hơn.

Khối bình luận mặc định, hiển thị bên dưới khi khởi chạy.#
khi bắt đầu :: hat events
[comment]

Lập trình viên sử dụng chú thích để sắp xếp mã của họ và làm cho mã dễ đọc và dễ hiểu hơn, cả cho chính họ khi quay lại dự án sau này và cho những người khác cùng làm việc trên dự án đó. Tên của một khối chỉ mô tả khối đó, nhưng một chú thích có thể mô tả hành vi của toàn bộ một nhóm khối cùng một lúc — vì vậy bạn có thể hiểu được một chồng khối làm gì chỉ bằng một cái nhìn thoáng qua, mà không cần phải đọc qua từng khối riêng lẻ.

Ví dụ, dự án này tiến về phía trước cho đến khi va phải vật cản, rồi lùi lại. Như đã viết, để hiểu được điều đó cần phải đọc kỹ từng đoạn mã.

Một dự án tiến về phía trước cho đến khi gặp chướng ngại vật, rồi lùi lại.#
khi bắt đầu :: hat events
lái [tiến v]
chờ cho đến khi <[bumper v] được nhấn? :: custom-led>
dừng lái
lái [lùi v] trong (100) [mm v] ▶

Việc thêm phần chú thích phía trên mỗi mục mô tả hoạt động của mục đó, giúp người dùng dễ dàng hiểu dự án chỉ bằng một cái nhìn tổng quan.

Cùng một dự án, kèm theo các chú thích mô tả hoạt động của từng phần.#
khi bắt đầu :: hat events
[Drive forward until something is in the way.]
lái [tiến v]
chờ cho đến khi <[bumper v] được nhấn? :: custom-led>
[Back away from the object.]
dừng lái
lái [lùi v] trong (100) [mm v] ▶

Sau khi kết nối robot của bạn với VEXcode, hãy chọn Bắt đầu để chạy dự án. Robot sẽ di chuyển về phía trước, dừng lại và lùi lại khi va chạm với vật gì đó.

Ảnh chụp màn hình thanh công cụ VEXcode GO, với nút Bắt đầu được tô sáng.