This question already has an answer here:
- Purpose of Unions in C and C++ 14 answers
In the comments of this answer it is said that it would be undefined behavior to split up an integer into their bytes using a union like follows. The code given at that place is similar though not identical to this, please give a note if have I changed undefined-behavior-relevant aspects of the code.
union addr {
uint8_t addr8[4];
uint32_t addr32;
};
Up to now I thought this would be a fine approach to do things like addr = {127, 0, 0, 1};
and get the corresponding uint32_t
in return. (I acknowledge that this may yield different results depending on the endianness of my system. The question however remains.)
Is this undefined behavior? If so, why? (I don't know what means What's UB in C++ is to access inactive union members.)
C99
- C99 is apparantly pretty close to C++03 in this point.
C++03
- In a union, at most one of the data members can be active at any time, that is, the value of at most one of the data members can be stored in a union at any time. C++03, Section 9.5 (1), page 162
However
- If a POD-union contains several POD-structs that share a common initial sequence [...] it is permitted to inspect the common initial sequence of any of POD-struct members ibid.
- Two POD-struct [...] types are layout-compatible if they have the same number of nonstatic data members, and corresponding nonstatic data members (in order) have layout-compatible types C++03, Section 9.2 (14), page 157
- If two types T1 and T2 are the same type, then T1 and T2 are layout-compatible types. C++03, Section 3.9 (11), page 53
Conclusion
- as
uint8_t[4]
anduint32_t
are not the same type (I guess, a strict aliasing thing) (plus both not being POD-structs/union) the above is indeed UB?
C++11
- Note that aggregate type does not include union type because an object with union type can only contain one member at a time. C++11, Footnote 46, page 42
Basically because in C++ you are allowed to access just the active member of an union.
This means that if you set
addr8
then you should access just that one until you setaddr32
, so that you can access it and so on. Setting one member to access data from another one is what should cause undefined behavior.A member is considered active when you set it, and it remains so until another one becomes the active one.
[edit: read my edited section below, as I'm now unsure of whether this is undefined behavior or not; I'll leave the majority of my answer the same, however, until I can confirm further] Yes, this is undefined behavior. The C++ Standard, section 9.5.1, states:
This means that only the most recently written to member can validly be read from as well (reading from the others is technically undefined behavior). Only one member of the union can be active at any time. Not two.
You might ask why? Consider your example. C++ does not mandate the endianness of
addr32
. It could be big-endian, little-endian, or middle-endian. If you write toaddr8
, and then read fromaddr32
, C++ cannot guarantee you'll get the right value out because of the endianness in this case. One one computer, it could be one value, and on another, it could be a different value. Hence, doing so (that is, writing to one member and reading a different one) is undefined behavior.Edit: For those wondering what "active" means, the MSDN documentation on Unions states:
Edit Edit: I had always thought the behavior of doing this was undefined, but now I'm not so sure after R. Martinho Fernandes's comments and answer and after re-reading the quote from MSDN. The value is certainly unspecified/undefined, but now I'm not so sure if the behavior is (undefined value means you might get different results back; undefined behavior means your system might crash, the two being different things). I'm going to consider this further and talk with others I know to see if I can find a more explicit answer.
I do think it's safe to say, however, that in general reading an inactive member in a union can be undefined behavior (except for the special note in the Standard, of course), but I don't know if it always is (i.e. there may be some exceptions beyond the special note in the section of the C++ Standard I've quoted).
Basically what it means is that the only member you can read from a union without invoking undefined behavior is the last written one. In other words, if you write to
addr32
, you can only read fromaddr32
, notaddr8
and vice versa.An example is also available here.
Edit: Since there has been much discussion if this is UB or not, consider the following (fully valid) C++11 example;
Here you can definitely see that activating str and reading wstr may be a problem. You could see this as an extreme example since you even have to activate the member by doing a placement new, but the spec actually covers this case with no mention that it's to be considered a special case in other ways regarding active members.
Frankly, I can't find any mention in the standard that doing this is undefined behaviour. The standard does define the notion of "active member" for unions, but it doesn't seem to use that idea for anything other than explaining how to change the active member (§9.5p4), and to define constant expressions (§5.9p2). Specifically it doesn't seem to make explicit mention of validity of accessing either the active or the non-active members.
As far as I can see, something like the following can cause a strict aliasing violation, which is undefined behaviour:
This doesn't lead to strict aliasing violations because of some special rule for unions. It happens if you access the same memory location using types that can't be aliased, i.e., a "normal" strict aliasing violation.
But, since there's an exception for
char
when it comes to aliasing rules, the following does not lead to the same kind of violations:As far as I can see, there is nothing in the standard that leaves the following code with undefined behaviour: