Hàm Arduino: viết một lần, gọi ở bất cứ đâu
Hoặc xem mọi bài học.
- 526linh kiện trên bàn làm mạch
- 46bo mạch đang chạy
- 1.00xthời gian thực, trên mọi bo mạch
Hàm là một khối code có tên, bạn có thể chạy nó từ bất cứ đâu trong sketch bằng cách viết tên nó. void flash(int pin, int times) là một hàm chớp bất kỳ chân nào bất kỳ số lần nào, nên thay vì chép lại cùng bốn dòng cho mỗi LED, bạn viết flash(13, 1), flash(12, 2) và flash(11, 3). setup() và loop() cũng là hàm; bạn vẫn đang viết chúng suốt từ trước đến nay.
Mạch ở trên có ba đèn ở chân 13, 12 và 11, được điều khiển đúng bằng hàm đó. Hãy nhấn Chạy. Serial Monitor in "three lamps, one flash function", rồi "pin 13 flashes 1 times", "pin 12 flashes 2 times" và "pin 11 flashes 3 times", và mỗi đèn làm đúng như dòng của nó nói.
Dưới đây là hình dạng của một hàm, các hàm trả về kết quả, vì sao thay đổi một tham số không ảnh hưởng gì đến bên gọi, hàm có thể đặt ở đâu và không thể đặt ở đâu, cùng các thông báo lỗi cho từng lỗi.
Muốn học từng bước? Bài học "Write it once" sẽ hướng dẫn bạn qua nội dung này với các điểm kiểm tra.
Mở bài họcHình dạng của một hàm
Một hàm có kiểu trả về, tên hàm và các tham số trong ngoặc, rồi thân hàm trong ngoặc nhọn. Trong void flash(int pin, int times, int onMs), void nghĩa là hàm không trả về gì, flash là tên, và ba số int là những con số bên gọi phải đưa cho hàm. Bên trong, pin, times và onMs là những biến thường chứa giá trị mà bên gọi truyền vào.
Hai hàm nhỏ ngay sau nó trả lời một câu hỏi thay vì làm một việc. lampFor(round) trả về chân cho một vòng và timesFor(round) trả về số lần chớp, và loop() dùng kết quả của chúng. Đổi return round + 1; thành return round + 2; thì mọi đèn sẽ chớp thêm một lần.
void flash(int pin, int times, int onMs) {
for (int i = 0; i < times; i++) {
digitalWrite(pin, HIGH);
delay(onMs);
digitalWrite(pin, LOW);
delay(onMs);
}
}
int lampFor(int round) {
if (round == 0) return LAMP_A;
if (round == 1) return LAMP_B;
return LAMP_C;
}
int timesFor(int round) {
return round + 1;
}Trả về một giá trị
Bất kỳ kiểu nào khác void đều nghĩa là hàm trả về một giá trị thuộc kiểu đó, và return là cách làm. Bên gọi có thể in nó, lưu nó hoặc dùng nó trong một phép tính. Ở dưới, twice(21) đã in ra 42.
Chú ý rằng twice() được viết sau setup(), là nơi gọi nó. Trong C++ thuần đó là lỗi, vì trình biên dịch đọc từ trên xuống và chưa thấy twice. Arduino IDE âm thầm thêm khai báo cho mọi hàm trong một tệp .ino lên đầu trước khi biên dịch, và Mokxi cũng làm vậy, nên trong sketch của bạn thứ tự không quan trọng.
void setup() {
Serial.begin(9600);
Serial.println(twice(21));
}
void loop() {
}
int twice(int x) {
return x * 2;
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Tham số là bản sao
Một tham số là bản sao của thứ bên gọi truyền vào. addOne(score) ở dưới cộng một vào bản sao của riêng nó rồi vứt đi, nên score vẫn in ra 5 sau đó. Phần lớn thời gian đó chính là điều bạn muốn: một hàm không thể âm thầm thay đổi biến của bạn.
Khi bạn muốn nó làm vậy, hãy thêm & sau kiểu. void addOneRef(int &n) nhận một tham chiếu, là chính biến của bên gọi dưới một tên khác, và sau addOneRef(score) nó in ra 6. Tham chiếu cũng là cách thường dùng để lấy hai kết quả từ một hàm: minMax(7, 3, lo, hi) đã điền cả hai và in "3 7".
void addOne(int n) {
n = n + 1;
}
void addOneRef(int &n) {
n = n + 1;
}
void setup() {
Serial.begin(9600);
int score = 5;
addOne(score);
Serial.println(score);
addOneRef(score);
Serial.println(score);
}
void loop() {
}Mở sketch này trong trình soạn codeChỉ riêng phần code: trình soạn code sẽ tự đặt bo mạch và các linh kiện mà nó đọc được từ sketch.
Hàm đặt ở đâu, và các lỗi khi đặt sai chỗ
Một hàm nằm ngoài mọi hàm khác, ở tầng cao nhất của tệp, thường sau loop() hoặc phía trên setup(). Hãy giữ mỗi hàm ngắn gọn và đặt tên nói lên việc nó làm, chẳng hạn readTemperature() hay flashError(), và loop() sẽ đọc như một danh sách các bước. Viết một hàm bên trong setup() thì bản build dừng lại. Mokxi biên dịch bằng clang, với dòng chữ function definition is not allowed here; GCC của Arduino IDE nói a function-definition is not allowed here before '{' token. Gần như luôn luôn nghĩa là thiếu một dấu ngoặc đóng phía trên, nên trình biên dịch tưởng bạn vẫn còn ở trong setup(). Hãy đếm ngoặc của bạn.
Một hàm hứa trả về giá trị thì phải trả về trên mọi đường đi. int f(int x) { if (x > 0) return 1; } vẫn biên dịch được, kèm cảnh báo: non-void function does not return a value in all control paths. Gọi f(-5) và bạn nhận được giá trị nào tình cờ còn sót lại, ở đây là in ra 1. Hãy thêm một return ở cuối, dù chỉ là return 0;.
Hàm nằm trong một tab .cpp riêng sẽ không được khai báo tự động như trong tệp .ino. Khi ta chuyển một hàm sang tab tên là more.cpp, sketch bị lỗi use of undeclared identifier 'helper'. Hãy thêm khai báo void helper(); vào một file header như more.h và #include "more.h" ở đầu sketch, thế là biên dịch được.
Mở mạch này trong trình soạn thảo. Bo mạch Arduino Uno: ba đèn, một hàm flash, được nối dây như khi chạy ở đầu trang này. Thay một linh kiện hoặc một giá trị rồi chạy lại nhé.
Câu hỏi
void trong Arduino nghĩa là gì?
Là hàm đó không trả về gì cả. void setup() và void loop() làm một việc và không trả về giá trị nào. Hàm trả lời một câu hỏi thì có kiểu, ví dụ int hoặc float, và kết thúc bằng return.
Tôi có cần khai báo hàm trước khi dùng trong Arduino không?
Trong tệp .ino thì không: Arduino IDE sẽ tự thêm khai báo giúp bạn trước khi biên dịch, Mokxi cũng vậy, nên hàm có thể viết dưới phần code gọi nó. Còn trong tệp .cpp thì có, thường là trong một file header.
Làm sao để trả về hai giá trị từ một hàm?
Truyền hai biến theo tham chiếu, thêm & sau kiểu, rồi gán giá trị bên trong hàm. Hoặc trả về một struct chứa cả hai. Ví dụ minMax() trên trang này điền một giá trị thấp và một giá trị cao theo cách này.
Vì sao thay đổi tham số lại không thay đổi biến của tôi?
Vì tham số chỉ là một bản sao. Thay đổi nó chỉ thay đổi bản sao thôi. Hãy khai báo tham số là tham chiếu, int &n thay vì int n, nếu hàm cần thay đổi biến của bên gọi.
"a function-definition is not allowed here" nghĩa là gì?
Là một hàm đang được định nghĩa bên trong một hàm khác, gần như luôn là do thiếu một dấu ngoặc đóng phía trên. Tìm hàm nằm trước lỗi và kiểm tra xem mọi { đã có } tương ứng chưa.
Hàm trong Arduino có trả về được một mảng không?
Không trả về được dưới dạng mảng. Hàm có thể trả về một con trỏ, nhưng trả về địa chỉ của mảng cục bộ là một bug: bản biên dịch vẫn qua được kèm cảnh báo address of stack memory associated with local variable 'a' returned, vì mảng đã biến mất sau khi hàm kết thúc. Hãy truyền mảng vào như một tham số và điền giá trị vào, hoặc trả về một struct chứa các giá trị.
Tiếp tục nào
Thông tin trên trang này lấy từ đâu
Lắp mạch này ngoài đời
Mở trình soạn thảo, đổi một giá trị và xem con số thay đổi theo. Không cần cài gì, không cần tài khoản.