aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/cpp/unsignedint.rst
blob: f8ea4738fe81ba1fc3a1cca48b8284baf5380b7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
.. highlight:: cpp

.. _lang-unsignedint:

``unsigned int``
================

An ``unsigned int`` (unsigned integer) is the same as an :ref:`int
<lang-int>` in that it stores a 4 byte integer value.  However,
Instead of storing both negative and positive numbers, an ``unsigned
int`` can only store nonnegative values, yielding a range of 0 to
4,294,967,295 (the positive value is 2^32 - 1).

The difference between an ``unsigned int`` and a (signed) ``int`` lies
in the way the highest bit, sometimes referred to as the "sign" bit,
is interpreted.  In the case of the Maple ``int`` type (which is
signed), if the high bit is a "1", the number is interpreted as a
negative number, using a technique known as `two's complement math
<http://en.wikipedia.org/wiki/Two%27s_complement#Explanation>`_.  The
bits in an an ``unsigned int`` are interpreted according to the usual
rules for converting `binary to decimal
<http://en.wikipedia.org/wiki/Binary_numeral_system#Counting_in_binary>`_.

An ``unsigned int`` is subject to the same :ref:`overflow issues
<lang-int-overflow>` as a regular ``int``; the only difference is
that an ``unsigned int`` will "underflow" at 0, and "overflow" at
4,294,967,295.  Here is some example code which illustrates this::

       unsigned int x;
       x = 0;
       x--; // x now contains 4,294,967,295; rolled over "left to right"
       x++; // x now contains 0; rolled over "right to left"

.. _lang-unsignedlong:

The ``unsigned long`` type is a synonym for ``unsigned int``.

Here is an example of declaring an ``unsigned int`` variable named
``pin``, then giving it value 13::

        unsigned int pin = 13;

The general syntax for declaring an ``unsigned int`` variable named
``var``, then giving it value ``val``, looks like::

         unsigned int var = val;

See Also
--------

-  :ref:`int <lang-int>`
-  :ref:`char <lang-char>`
-  :ref:`unsigned char <lang-unsignedchar>`
-  :ref:`long long <lang-longlong>`
-  :ref:`unsigned long long <lang-unsignedlonglong>`
-  :ref:`Integer Constants <lang-constants-integers>`
-  :ref:`Variables <lang-variables>`

.. include:: /arduino-cc-attribution.txt