reorganized all the arduino/ docs into a lang/ subdirectory since

they're properly CC attributed now.

1 files changed, 53 insertions, 0 deletions

diff --git a/docs/source/lang/bytecast.rst b/docs/source/lang/bytecast.rst
new file mode 100644
index 0000000..4ad2a89
--- /dev/null
+++ b/docs/source/lang/bytecast.rst
@@ -0,0 +1,53 @@
+.. highlight:: cpp
+
+.. _lang-bytecast:
+
+byte() (cast)
+=============
+
+Description
+-----------
+
+Converts a value to the :ref:`byte <lang-byte>` data type.
+
+.. note::
+
+   Casting to the byte type is provided for compatibility with
+   Arduino.  However, the recommended Maple type for storing an 8-bit
+   unsigned integer is ``uint8``. (C and C++ programmers: ``stdint.h``
+   is also available).
+
+   In order to cast a variable ``x`` to a ``uint8``, the
+   following syntax can be used::
+
+       uint8(x);
+
+Syntax
+------
+
+``byte(x)``
+
+
+Parameters
+----------
+
+**x**: a value of any integer type
+
+
+Returns
+-------
+
+The value, converted to a ``byte``.  Note, however, that if the value
+is larger than the maximum value you can store in a byte (255), then
+the results might be strange and unexpected.
+
+
+See Also
+--------
+
+-  :ref:`lang-byte`
+
+
+
+
+.. include:: cc-attribution.txt