diff options
| author | Marti Bolivar <mbolivar@mit.edu> | 2010-11-28 11:23:33 -0500 | 
|---|---|---|
| committer | Marti Bolivar <mbolivar@mit.edu> | 2010-11-28 11:23:33 -0500 | 
| commit | d9cbd78e29d42e70bb46641dd43ee0772c8c975f (patch) | |
| tree | 80a67cba4468dbcd89b3cd23ad56695b1f146c66 /source/arduino/sizeof.rst | |
| parent | 546b34076d230b617ba86defb6b90cd934b01878 (diff) | |
| download | librambutan-d9cbd78e29d42e70bb46641dd43ee0772c8c975f.tar.gz librambutan-d9cbd78e29d42e70bb46641dd43ee0772c8c975f.zip | |
reorganized all the arduino/ docs into a lang/ subdirectory since
they're properly CC attributed now.
Diffstat (limited to 'source/arduino/sizeof.rst')
| -rw-r--r-- | source/arduino/sizeof.rst | 64 | 
1 files changed, 0 insertions, 64 deletions
| diff --git a/source/arduino/sizeof.rst b/source/arduino/sizeof.rst deleted file mode 100644 index 7c31809..0000000 --- a/source/arduino/sizeof.rst +++ /dev/null @@ -1,64 +0,0 @@ -.. highlight:: cpp - -.. _arduino-sizeof: - -sizeof() -======== - -The ``sizeof`` operator on the Maple returns the number of bytes -needed to store a value of a given type\ [#fcharsize]_.  This can be -an ordinary numeric type, like ``int``.  It can be something more -complicated, like a ``struct`` or ``union``.  If the argument to -``sizeof`` is an array, it returns the total number of bytes occupied -by the array. - -The general syntax looks like this:: - -    sizeof(type) -    sizeof(var) - -Example -------- - -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 ``int``, the :ref:`for loop <arduino-for>` -would look something like this:: - -    for (i = 0; i < (sizeof(myInts)/sizeof(int)) - 1; i++) { -      // do something with myInts[i] -    } - -.. rubric:: Footnotes - -.. [#fcharsize] Technically (and pedantically) speaking, ``sizeof`` -   returns a multiple of the number of bits a ``char`` occupies in -   memory.  However, on the Maple (this goes for most C++ -   implementations), a ``char`` occupies 8 bits = 1 byte.  All the C++ -   standard guarantees, however, is that a ``char`` occupies at -   *least* 8 bits. - -.. include:: cc-attribution.txt - | 
