Comments - Viết tài liệu tham khảo trong khi viết code Arduino

Giới thiệu

Bạn rất khó ghi nhớ từng dòng code một trong một chương trình thật là dài, với những thuật toán phức tạp, vì vậy Arduino đã làm cho bạn một cú pháp để giải quyết vấn đề này, đó là Comments. Comments sẽ giúp bạn ghi chú cho từng dòng code hoặc trình bày nhiệm vụ của nó để bạn hoặc những người khác có thể hiểu được chương trình này làm được những gì. Và comments sẽ không được Arduino biên dịch nên cho dù bạn viết nó dài đến đâu thì cũng không ảnh hưởng đến bộ nhớ flash của vi điều khiển. Để comments trong Arduino, bạn có 2 cách.

Ví dụ

 x = 5;  // Đây là kiểu "single line comment", để làm được điều này, bạn gõ "//"
         // nó sẽ ghi chú tất cả những chữ (text, câu lệnh,... everything) nằm sau dấu // cho đến khi hết dòng

/* Còn đây là "multiline comment" - Bạn bắt đầu ghi chú với ký tự kia.
Nó sẽ "ghi chú" tất cả những gì nằm trong cặp dấu "/ *" và "* /" ( không có dấu cách nhé)
if (gwb == 0){   // ngoài ra bạn có thể dùng single line trong này.
x = 3;           /* nhưng dùng một multiline comment khác thì sẽ bị lỗi cú pháp ngay */
}
// và đừng bao giờ quên ký tự đóng "* /" (ko có dấu cách) nhé!
*/

Gợi ý

Bạn sẽ dùng "single line comment" khi bạn cần ghi chú một đoạn code, ví dụ như ghi cách hiểu nó, nó trả về cái gì,..

Bạn sẽ dùng "multiline comment" để debug. Khi bạn thêm một đoạn code mới vô và cô tình làm cho chương trình hoạt động lỗi thì bạn hãy thử dùng multiline comment để đánh dấu là ghi chú những dòng đó (chương trình dịch sẽ bỏ qua). Sau đó, bạn xem thử chương trình có chạy đúng hay không, nếu có lỗi thì mở rộng single line comment lên những dòng code trước đó nữa, còn nếu không thì bạn thu hẹp multiline comment lại và tiếp tục thực hiện những gì tôi vừa ghi!

Reference Tags: 
lên
11 thành viên đã đánh giá bài viết này hữu ích.
Các bài viết cùng tác giả

Tạo một quy trình công nghiệp với các bước bằng Arduino - Phần 3: Giới hạn số lần chạy và kết hợp thư viện bất đồng bộ

Ở trong loạt bài này và một bài viết khác, mình đã đề cập đến vấn đề quy trình Công nghiệp (phần 1phần 2) và vấn đề xử lý bất đồng bộ trên Arduino. Hôm nay, mình muốn phát triển loạt bài này với mục đích, bạn có thể xây dựng một máy công nghiệp với các quy trình tuần tự nhưng có thể can thiệp để dừng ngay được. Ngoài ra, mình còn cập nhập thêm khả năng quy ước trước số lượt chạy của quy trình và một số API khác giúp cho các bạn có thể kết hợp lại 2 thư viện này! Để đọc hiểu, và tiếp cận nhanh bài này, các bạn cần đọc 3 bài viết mà mình có liên kết trong đoạn giới thiệu này.

lên
12 thành viên đã đánh giá bài viết này hữu ích.

Cách dữ liệu được truyền đi trong sóng vô tuyến

Có 2 phương thức truyền dữ liệu bằng sóng vô tuyến, đó là AM và FM. Chắc hẳn, bạn đã từng nghe qua 2 khái niệm đó rồi phải không nào? Nếu không nhớ thì bạn hãy tìm ngay một chiếc radio và bật lên để cùng nghe những thông tin bổ ích từ các đài phát thanh qua sóng FM. Hôm nay, chúng ta sẽ cùng nhau tìm hiểu về 2 phương thức này, cái nào tốt hơn cái nào nhé.

lên
15 thành viên đã đánh giá bài viết này hữu ích.