Added an example and Notes and warnings#749
Conversation
Code was tested on Arduino Mega 2560.
|
|
per1234
left a comment
There was a problem hiding this comment.
You added the content inside the "see_also" block instead of creating a new "howtouse" block. This resulted in an invalid Asciidoc document which would break the website generator.
Please move the content out of the "see_also" block, following the reference sample here:
| [float] | ||
| === Example Code | ||
| // Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ | ||
| Prints the output of `bit(n)` for n=0 to n=10 to the serial monitor. Values returned are 1 2 4 8 16 till 1024. |
There was a problem hiding this comment.
| Prints the output of `bit(n)` for n=0 to n=10 to the serial monitor. Values returned are 1 2 4 8 16 till 1024. | |
| Prints the output of `bit(n)` for n=0 to n=10 to the Serial Monitor. Values returned are 1 2 4 8 16 till 1024. |
Use correct capitalization for Arduino's "Serial Monitor" tool
| [source,arduino] | ||
| ---- | ||
| void setup() { | ||
| Serial.begin(9600); |
There was a problem hiding this comment.
| Serial.begin(9600); | |
| Serial.begin(9600); |
Correctly format code
| ---- | ||
| void setup() { | ||
| Serial.begin(9600); | ||
| } |
There was a problem hiding this comment.
| } | |
| while (!Serial) { | |
| ; // wait for serial port to connect. Needed for native USB port only | |
| } | |
| } |
This will ensure those using a board like the Leonardo will see all the sketch output from n=0.
| for(int n=0;n<=10;n++) //loop from n=0 till 10 | ||
| { | ||
| Serial.print(" "); //space between numbers, for readability | ||
| Serial.print(bit(n)); //print the value of bit(n) | ||
| delay(1000); |
There was a problem hiding this comment.
| for(int n=0;n<=10;n++) //loop from n=0 till 10 | |
| { | |
| Serial.print(" "); //space between numbers, for readability | |
| Serial.print(bit(n)); //print the value of bit(n) | |
| delay(1000); | |
| //loop from n=0 till 10 | |
| for (int n = 0; n <= 10; n++) { | |
| Serial.print(" "); //space between numbers, for readability | |
| Serial.print(bit(n)); //print the value of bit(n) | |
| delay(1000); |
Use the standard Arduino code formatting style, as implemented by the default configuration of the Arduino IDE "Auto Format" feature.
|
|
||
| [float] | ||
| === Notes and Warnings | ||
| The variable `n` must be an integer type. float and double will return an error and the program will not compile. |
There was a problem hiding this comment.
It seems better to specify the parameter type in the "Parameters" section of the reference page.
I'm not sure what the best approach is for defining types of parameters of macros such as bit:
https://github.com/arduino/ArduinoCore-API/blob/1.3.1/api/Common.h#L71
Code was tested on Arduino Mega 2560.