4.5 — Unsigned integers, and why to avoid them

Unsigned integers

In the previous lesson (4.4 -- Signed integers), we covered signed integers, which are a set of types that can hold positive and negative whole numbers, including 0.

C++ also supports unsigned integers. Unsigned integers are integers that can only hold non-negative whole numbers.

Defining unsigned integers

To define an unsigned integer, we use the unsigned keyword. By convention, this is placed before the type:

Unsigned integer range

A 1-byte unsigned integer has a range of 0 to 255. Compare this to the 1-byte signed integer range of -128 to 127. Both can store 256 different values, but signed integers use half of their range for negative numbers, whereas unsigned integers can store positive numbers that are twice as large.

Here’s a table showing the range for unsigned integers:

Size/Type Range
1 byte unsigned 0 to 255
2 byte unsigned 0 to 65,535
4 byte unsigned 0 to 4,294,967,295
8 byte unsigned 0 to 18,446,744,073,709,551,615

An n-bit unsigned variable has a range of 0 to (2n)-1.

When no negative numbers are required, unsigned integers are well-suited for networking and systems with little memory, because unsigned integers can store more positive numbers without taking up extra memory.

Remembering the terms signed and unsigned

New programmers sometimes get signed and unsigned mixed up. The following is a simple way to remember the difference: in order to differentiate negative numbers from positive ones, we use a negative sign. If a sign is not provided, we assume a number is positive. Consequently, an integer with a sign (a signed integer) can tell the difference between positive and negative. An integer without a sign (an unsigned integer) assumes all values are positive.

Unsigned integer overflow

Trick question: What happens if we try to store the number 280 (which requires 9 bits to represent) in a 1-byte unsigned integer? You might think the answer is “overflow!”. But, it’s not.

By definition, unsigned integers cannot overflow. Instead, if a value is out of range, it is divided by one greater than the largest number of the type, and only the remainder kept.

The number 280 is too big to fit in our 1-byte range of 0 to 255. 1 greater than the largest number of the type is 256. Therefore, we divide 280 by 256, getting 1 remainder 24. The remainder of 24 is what is stored.

Here’s another way to think about the same thing. Any number bigger than the largest number representable by the type simply “wraps around” (sometimes called “modulo wrapping”). 255 is in range of a 1-byte integer, so 255 is fine. 256, however, is outside the range, so it wraps around to the value 0. 257 wraps around to the value 1. 280 wraps around to the value 24.

Let’s take a look at this using 2-byte integers:

What do you think the result of this program will be?

x was: 65535
x is now: 0
x is now: 1

It’s possible to wrap around the other direction as well. 0 is representable in a 1-byte integer, so that’s fine. -1 is not representable, so it wraps around to the top of the range, producing the value 255. -2 wraps around to 254. And so forth.

x was: 0
x is now: 65535
x is now: 65534

The above code triggers a warning in some compilers, because the compiler detects that the integer literal is out-of-range for the given type. If you want to compile the code anyway, temporarily disable “Treat warnings as errors”.

Author's note

In common language, unsigned integer wrap around is often incorrectly called “overflow” since the cause is identical to signed integer overflow.

As an aside...

Many notable bugs in video game history happened due to wrap around behavior with unsigned integers. In the arcade game Donkey Kong, it’s not possible to go past level 22 due to a bug that leaves the user with not enough bonus time to complete the level. In the PC game Civilization, Gandhi was known for being the first one to use nuclear weapons, which seems contrary to his normally passive nature. Gandhi’s aggression setting was normally set at 1, but if he chose a democratic government, he’d get a -2 modifier. This wrapped around his aggression setting to 255, making him maximally aggressive!

The controversy over unsigned numbers

Many developers (and some large development houses, such as Google) believe that developers should generally avoid unsigned integers.

This is largely because of two behaviors that can cause problems.

First, consider the subtraction of two unsigned numbers, such as 3 and 5. 3 minus 5 is -2, but -2 can’t be represented as an unsigned number.

On the author’s machine, this seemingly innocent looking program produces the result:

This occurs due to -2 wrapping around to a number close to the top of the range of a 4-byte integer. A common unwanted wrap-around happens when an unsigned integer is repeatedly decremented with the -- operator. You’ll see an example of this when loops are introduced.

Second, unexpected behavior can result when you mix signed and unsigned integers. In the above example, even if one of the operands (x or y) is signed, the other operand (the unsigned one) will cause the signed one to be promoted to an unsigned integer, and the same behavior will result!

Consider the following snippet:

The author of doSomething() was expecting someone to call this function with only positive numbers. But the caller is passing in -1. What happens in this case?

The signed argument of -1 gets implicitly converted to an unsigned parameter. -1 isn’t in the range of an unsigned number, so it wraps around to some large number (probably 4294967295). Then your program goes ballistic. Worse, there’s no good way to guard against this condition from happening. C++ will freely convert between signed and unsigned numbers, but it won’t do any range checking to make sure you don’t overflow your type.

If you need to protect a function against negative inputs, use an assertion or exception instead. Both are covered later.

Some modern programming languages (such as Java) and frameworks (such as .NET) either don’t include unsigned types, or limit their use.

New programmers often use unsigned integers to represent non-negative data, or to take advantage of the additional range. Bjarne Stroustrup, the designer of C++, said, “Using an unsigned instead of an int to gain one more bit to represent positive integers is almost never a good idea”.


Avoid using unsigned numbers, except in specific cases or when unavoidable.

Don’t avoid negative numbers by using unsigned types. If you need a larger range than a signed number offers, use one of the guaranteed-width integers shown in the next lesson (4.6 -- Fixed-width integers and size_t).

If you do use unsigned numbers, avoid mixing signed and unsigned numbers where possible.

So where is it reasonable to use unsigned numbers?

There are still a few cases in C++ where it’s okay (or necessary) to use unsigned numbers.

First, unsigned numbers are preferred when dealing with bit manipulation (covered in chapter O (That’s a capital ‘o’, not a ‘0’).

Second, use of unsigned numbers is still unavoidable in some cases, mainly those having to do with array indexing. We’ll talk more about this in the lessons on arrays and array indexing.

Also note that if you’re developing for an embedded system (e.g. an Arduino) or some other processor/memory limited context, use of unsigned numbers is more common and accepted (and in some cases, unavoidable) for performance reasons.

4.6 -- Fixed-width integers and size_t
4.4 -- Signed integers

106 comments to 4.5 — Unsigned integers, and why to avoid them

  • iCwhatyoudidthere

    So we should avoid unsigned integers because they have a known behavior when overflow/underflow occurs, as opposed to signed integers because they have undefined behavior when overflow/underflow occurs?  Wut?
    If the supplier of a function uses unsigned integers and specifies a precondition that only a certain range should be passed in as input, is it not on the client that calls said function to ensure that they do not violate the precondition?  Obviously, it would be bad practice to pass end user input to unsigned integers, but outside of that instance I fail to see how the problem of overflow/underflow is exclusive to unsigned integers.

  • yeokaiwei

    Your 2-byte integer example will trigger a warning on Visual Studio 2019.

    "Severity    Code    Description    Project    File    Line    Suppression State
    Error    C2220    the following warning is treated as an error    Bytes    C:\Users\user\source\repos\Bytes\Bytes\Bytes.cpp    8    
    Warning    C4305    '=': truncation from 'int' to 'unsigned short'    Bytes    C:\Users\user\source\repos\Bytes\Bytes\Bytes.cpp    8    
    Warning    C4309    '=': truncation of constant value    Bytes    C:\Users\user\source\repos\Bytes\Bytes\Bytes.cpp    8    
    Warning    C4305    '=': truncation from 'int' to 'unsigned short'    Bytes    C:\Users\user\source\repos\Bytes\Bytes\Bytes.cpp    11    
    Warning    C4309    '=': truncation of constant value    Bytes    C:\Users\user\source\repos\Bytes\Bytes\Bytes.cpp    11"

  • Evan Kilpatrick

    It is chapter letter O not chapter 0 It confused the crap out of me I went back looking like i missed something to find i hadn't gotten there yet just head up for anyone else

  • Steve

    I got a warning about signed/unsigned mismatch. The line in question was this

    where cars is a vector of pointers to Car objects. If I change i to be unsigned then the warning goes away, but I don't really understand how or why it wants to be unsigned or if I should do something different.

    • nascardriver

      `std::vector::size()` returns some unsigned integer type. `i` is a signed integer, so you get a warning about comparing a signed and an unsigned integer. If possible, use a range-based for-loop. If you do need the index, make its type `std::size_t`, which is what most containers use.

  • Manish

    Hi,thank you for great lessons. I need to ask a query on the "wrap around" thing.

    In a code if I use std::cin() to input the overflown value (like 65538) to unsigned short, it does not wrap around but takes the maximum value. On the other hand, in C, the scanf() does wrap around.

    Response: No wrap around for overflown input integer.

    In C :

    Response: Overflown input integer gets wrap around.

    I couldn't find any resource that explains it.

    • nascardriver

      I won't look into `std::scanf`, it's not as well documented as the newer functions.
      For `std::cin>>`
      "extracts an integer value by calling std::num_get::get()."
      "The input is parsed as if by [...] std::strtoull for unsigned integer"
      "If the converted value falls out of range of corresponding return type, range error occurs and ULONG_MAX or ULLONG_MAX is returned"

      Back to
      "If the conversion function results in a value not to fit in the type of v which is an unsigned integer type, the most positive representable value is stored in v."

      • Manish

        Thank you nascardriver for reply and detailed explanation. This pretty much explains it. I need to put more efforts to understand references.

  • faskldj

    Sorry, but your arguments are not very good.

    Most importantly, you completely ignored the main problem with signed variables: Overflow will cause UB, UB is something you may not notice till the software is used in production and everything breaks.
    You also ignored the difference between integer that are used to store numbers and other uses such as indexes, number of elements, addresses or to identify an "object" (such as file descriptors).

    "Many notable bugs in video game history happened due to wrap around behavior with unsigned integers. In the arcade game Donkey Kong, it’s not possible to go past level 22 due to a bug that leaves the user with not enough bonus time to complete the level."
    This is not an argument against using unsigned, the oposite is true. When you have the same problem with signed integers, it would cause an overflow and UB. In C++ you always have to make sure the type range covers all possible cases, this is the case for signed and unsigned variables. If you do not do that you get UB in case of a signed type or unexpected behaviour in case of a unsigned type.

    The argument with substracting 5 from 3 is not an argument against using unsigned. When you use signed you can run into a similar problem when the result underflows. This happens much less frequent and causes UB, at INT_MIN, which is the worst kind of bug. The bug is often not triggered durring testing and you will only notice it when it is too late.
    Bugs that occur around 0, for unsigned types, are much more likely to be seen during testing and they can be fixed, if they don't they do not cause UB right away.

    Trying to store -1 to a unsigned variable, which is out of the range of a unsigned variable, is also not an argument against unsigned. A worse problem happens when you want to store a value outside of the range of a signed variable into that variable, you get UB.

    "If you need to protect a function against negative inputs, use an assertion or exception instead. Both are covered later."
    Many platforms do not have a meaningfull way to deal with a failed assertion. What do you want to do on a microcontroller, with no user, no files and not even stdout?

    "Some modern programming languages (such as Java) and frameworks (such as .NET) either don’t include unsigned types, or limit their use."
    Should that be an argument for avoiding unsigned? If so, it is an appeal to popularity fallacy.

    I do not say don't use signed, they have their use cases, but in most cases unsigned is better suited for the task. You always have to think about the type you use and choose the right type. Do never just use the next best type without thinking about it.

  • Nomic

    The story of Civilization of Gandhi is interesting.
    I googled this story, then found a news said that the designer deny ,but like the rumor. :)

  • TN

    I am using my computer and sizeof(int) = 4; sizeof(long double) = 12. The values are different compare to what you have.
    Any recommendation to configurate again the system or use it as it is now?

  • Yousuf

    I am using GCC 10.2 on 64bit computer. I turned off all the compilation flags, I simply tried to compile my *.cpp file from terminal, and it shows error `error: narrowing conversion of ‘-1’ from ‘int’ to ‘short unsigned int’ [-Wnarrowing]` . Seems GCC 10.2 doesn't let me wraps around negative values into unsigned short int. Any thoughts?
    Here is my code:

    • nascardriver

      This conversion was never allowed in list initialization. That's what list initialization is there for. It only allows conversions that don't change the value. Use one of the methods shown in the lesson.

  • Alessandro

    In the aside note (which, since I'm a new programmer, I like them lot because they give me the possibility to grasp real-world issues) you write that Gandhi with the Democratic Gov gets a -2 modifer which wrapped to a 255 level of aggressity. But should't be this value 254 based on what is written in the main text?

    • nascardriver

      I don't know this video game, but I'm guessing that Gandhi isn't assigned a -2, but instead 2 is subtracted from his initial modifier of 1. Then the example makes sense, because `1 - 2 == 255`

      • NuclearGandhi

        The first Civilization game released in 1991 and it included a feature that turned a lot of heads. Mahatma Gandhi, famous in real life for leading a series of peaceful protests that eventually ended British occupation of India, would suddenly become the most aggressive leader in the game once he acquired nuclear weapons. The apparent glitch became famous throughout the internet for turning the conception of such a peaceful figure on its head, and was immortalized in future games which consistently saw Gandhi as a nuclear warmonger. Most players believed that Gandhi's murderous intent was the result of an integer overflow glitch; his base aggression score was so low that when it was lowered by the advent of democracy it wrapped around to a number far higher than any leader should be able to achieve, causing him to suddenly aspire to nuke the world.

    • david

      It has been mentioned during a CS50 class.

Leave a Comment

Put all code inside code tags: [code]your code here[/code]