aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/arduino/sizeof.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@mit.edu>2010-10-20 06:46:52 -0400
committerMarti Bolivar <mbolivar@mit.edu>2010-10-20 06:46:52 -0400
commit22ff1db8a76c7047b61a424ae1fa5f43697fcb34 (patch)
treebf722c8a5a6bd40e0b33fc4a425e0e5b8b9f4216 /docs/source/arduino/sizeof.rst
parentbac6548fe90b0721e191d68df2677beb4b15f60a (diff)
downloadlibrambutan-22ff1db8a76c7047b61a424ae1fa5f43697fcb34.tar.gz
librambutan-22ff1db8a76c7047b61a424ae1fa5f43697fcb34.zip
initial check-in of arduino docs in RST format (converted using wget+pandoc)
Diffstat (limited to 'docs/source/arduino/sizeof.rst')
-rw-r--r--docs/source/arduino/sizeof.rst71
1 files changed, 71 insertions, 0 deletions
diff --git a/docs/source/arduino/sizeof.rst b/docs/source/arduino/sizeof.rst
new file mode 100644
index 0000000..a95dfbf
--- /dev/null
+++ b/docs/source/arduino/sizeof.rst
@@ -0,0 +1,71 @@
+.. _arduino-sizeof:
+
+sizeof
+======
+
+Description
+-----------
+
+The sizeof operator returns the number of bytes in a variable type,
+or the number of bytes occupied by an array.
+
+
+
+Syntax
+------
+
+sizeof(variable)
+
+
+
+Parameters
+----------
+
+variable: any variable type or array (e.g. int, float, byte)
+
+
+
+Example code
+------------
+
+The sizeof operator is useful for dealing with arrays (such as
+strings) where it is convenient to be able to change the size of
+the array without breaking other parts of the program.
+
+
+
+This program prints out a text string one character at a time. Try
+changing the text phrase.
+
+
+
+::
+
+ char myStr[] = "this is a test";
+ int i;
+
+ void setup(){
+ Serial.begin(9600);
+ }
+
+ void loop() {
+ for (i = 0; i < sizeof(myStr) - 1; i++){
+ Serial.print(i, DEC);
+ Serial.print(" = ");
+ Serial.println(myStr[i], BYTE);
+ }
+ }
+
+
+Note that sizeof returns the total number of bytes. So for larger
+variable types such as ints, the for loop would look something like
+this.
+
+
+
+::
+
+ for (i = 0; i < (sizeof(myInts)/sizeof(int)) - 1; i++) {
+ // do something with myInts[i]
+ }
+