# Tagged union

﻿
Tagged union

In computer science, a tagged union, also called a variant, variant record, "discriminated union", or disjoint union, is a data structure used to hold a value that could take on several different, but fixed types. Only one of the types can be in use at any one time, and a tag field explicitly indicates which one is in use. It can be thought of as a type which has several "cases," each of which should be handled correctly when that type is manipulated. Like ordinary unions, tagged unions can save storage by overlapping storage areas for each type, since only one is in use at a time.

Tagged unions are most important in functional languages such as ML and Haskell, where they are called datatypes (see algebraic data type) and the compiler is able to verify that all cases of a tagged union are always handled, avoiding many types of errors. They can, however, be constructed in nearly any language, and are much safer than untagged unions, often simply called unions, which are similar but do not explicitly keep track of which member of the union is currently in use.

Tagged unions are often accompanied by the concept of a constructor, which is similar but not the same as a constructor for a class. Constructors produce a tagged union value, given the initial tag value and a value of the corresponding type.

Mathematically, tagged unions correspond to "disjoint" or "discriminated unions", usually written using +. Given an element of a disjoint union "A" + "B", it is possible to determine whether it came from "A" or "B". If an element lies in both, there will be two effectively distinct copies of the value in "A" + "B", one from "A" and one from "B".

In type theory, a tagged union is called a "sum type". Notations vary, but usually the sum type $A+B$ comes with two introduction forms $mathrm\left\{inj\right\}_1 : A o A+B$ and $mathrm\left\{inj\right\}_2 : B o A+B$. The elimination form is case analysis: if $e$ has type $A+B$ and $e_1$ and $e_2$ have type $au$ under the assumptions $x:A$ and $y:B$ respectively, then the term $exttt\left\{case\right\} e exttt\left\{of\right\} x Rightarrow e_1 | y Rightarrow e_2$ has type $au$. The sum type corresponds to logical disjunction under the Curry-Howard correspondence.

The primary advantage of a tagged union over an untagged union is that all accesses are safe, and the compiler can even check that all cases are handled. Untagged unions depend on program logic to correctly identify the currently active field, which may result in strange behavior and hard-to-find bugs if that logic fails.

The primary advantage of a tagged union over a simple record containing a field for each type is that it saves storage by overlapping storage for all the types. Some implementations reserve enough storage for the largest type, while others dynamically adjust the size of a tagged union value as needed. When the value is "immutable", or cannot be changed, it is simple to allocate just as much storage as is needed.

The main disadvantage of tagged unions is that the tag occupies space. Since there are usually a small number of alternatives, the tag can often be squeezed into 2 or 3 bits wherever space can be found, but sometimes even these bits are not available. In this case, a helpful alternative may be folded, computed or encoded tags, where the tag value is dynamically computed from the contents of the union field. Common examples of this are the use of "reserved values", where, for example, a function returning a positive number may return -1 to indicate failure, and sentinel values, most often used in tagged pointers.

Sometimes, untagged unions are used to perform bit-level conversions between types, called reinterpret casts in C++. Tagged unions are not intended for this purpose; typically a new value is assigned whenever the tag is changed.

Many languages support, to some extent, a "universal data type", which is a type that includes every value of every other type, and often a way is provided to test the actual type of a value of the universal type. These are sometimes referred to as "variants". While universal data types are comparable to tagged unions in their formal definition, typical tagged unions include a relatively small number of cases, and these cases form different ways of expressing a single coherent concept, such as a data structure node or instruction. Also, there is an expectation that every possible case of a tagged union will be dealt with when it is used. The values of a universal data type are not related and there is no feasible way to deal with them all.

Examples

Say we wanted to build a binary tree of integers. In ML, we would do this by creating a datatype like this:

datatype tree = Leaf
Node of (int * tree * tree)

This is a tagged union with two cases: one, the leaf, is used to terminate a path of the tree, and functions much like a null value would in imperative languages. The other branch holds a node, which contains an integer and a left and right subtree. Leaf and Node are the constructors, which enable us to actually produce a particular tree, such as:

Node(5, Node(1,Leaf,Leaf), Node(3, Leaf, Node(4, Leaf, Leaf)))

which corresponds to this tree:

Now we can easily write a typesafe function that, say, counts the number of nodes in the tree:

fun countNodes(Leaf) = 0
countNodes(Node(int,left,right)) = 1 + countNodes(left) + countNodes(right)

Time line of language support

1960s

In Algol 68, tagged unions are called united modes, the tag is implicit, and the `case` construct is used to determine which field is tagged:

mode node = union (real, int, compl, string);

Usage example for `union` `case` of `node`:

node n := "1234"; case n in (real r): print(("real:", r)), (int i): print(("int:", i)), (compl c): print(("compl:", c)), (string s): print(("string:", s)) out print(("?:", n)) esac

1970s & 1980s

Although primarily only functional languages such as ML and Haskell (from 1990s) give a central role to tagged unions and have the power to check that all cases are handled, other languages have support for tagged unions as well. However, in practice they can be less efficient in non-functional languages due to optimizations enabled by functional language compilers that can eliminate explicit tag checks and avoid explicit storage of tags.

Pascal, Ada, and Modula-2 call them variant records, and require the tag field to be manually created and the tag values specified, as in this Pascal example:

type shapeKind = (square, rectangle, circle); shape = record centerx : integer; centery : integer; case kind : shapeKind of square : (side : integer); rectangle : (length, height : integer); circle : (radius : integer); end;

In C and C++, a tagged union can be created from untagged unions using a strict access discipline where the tag is always checked:

enum ShapeKind { Square, Rectangle, Circle };

struct Shape { int centerx; int centery; enum ShapeKind kind; union { struct { int side; } squareData; struct { int length, height; } rectangleData; struct { int radius; } circleData; } shapeKindData;};

int getSquareSide(struct Shape* s) { assert(s->kind = Square); return s->shapeKindData.squareData.side;}

void setSquareSide(struct Shape* s, int side) { s->kind = Square; s->shapeKindData.squareData.side = side;}

/* and so on */

As long as the union fields are only accessed through the functions, the accesses will be safe and correct. The same approach can be used for encoded tags; we simply decode the tag and then check it on each access. If the inefficiency of these tag checks is a concern, they may be automatically removed in the final version.

C and C++ also have language support for one particular tagged union: the possibly-null pointer. This may be compared to the `option` type in ML or the `Maybe` type in Haskell, and can be seen as a tagged pointer: a tagged union (with an encoded tag) of two types:
* Valid pointers,
* A type with only one value, `null`, indicating an exceptional condition.Unfortunately, C compilers do not verify that the null case is always handled, and this is a particularly prevalent source of errors in C code, since there is a tendency to ignore exceptional cases.

2000s

One advanced dialect of C called Cyclone has extensive built-in support for tagged unions. See [http://cyclone.thelanguage.org/wiki/Tagged%20Unions the tagged union section of the on-line manual] for more information.

The variant library from Boost has demonstrated it was possible to implement a safe tagged union as a library in C++, visitable using functors, a mechanism more or less equivalent to closures.struct display : boost::static_visitor{ void operator()(int i) { std::cout << "It's an int, with value " << i << std::endl; }

void operator()(const std::string& s) { std::cout << "It's a string, with value " << s << std::endl; ;

boost::variant v = 42;boost::apply_visitor(display(), v);

boost::variant v = "hello world";boost::apply_visitor(display(), v);

Class hierarchies as tagged unions

In a typical class hierarchy in object-oriented programming, each subclass can encapsulate data unique to that class. The metadata used to perform virtual method lookup (for example, the object's vtable pointer in most C++ implementations) identifies the subclass and so effectively acts as a tag identifying the particular data stored by the instance.An object's constructor sets this tag, and it remains constant throughout the object's lifetime.

* [http://www.boost.org/libs/variant/index.html boost::variant] is a C++ typesafe discriminated union
* [http://www.digitalmars.com/d/phobos/std_variant.html std.variant] is an implementation of variant type in D 2.0

* Discriminator

Wikimedia Foundation. 2010.

### Look at other dictionaries:

• Union (computer science) — In computer science, a union is a data structure that stores one of several types of data at a single location. There are only two safe ways of accessing a union object. One is to always read the field of a union most recently assigned; tagged… …   Wikipedia

• Tagged pointer — In computer science, a tagged pointer is a common example of a tagged union, where the primary type of data to be stored in the union is a pointer. Often, the tag in a tagged pointer will be folded into the data representing the pointer, taking… …   Wikipedia

• Tagged architecture — In computer science, a tagged architecture [ [http://www.memorymanagement.org/glossary/t.html#tagged.architecture The Memory Management Glossary: Tagged architecture] ] is a particular type of computer architecture where every word of memory… …   Wikipedia

• Union (programación) — Este artículo o sección sobre informática necesita ser wikificado con un formato acorde a las convenciones de estilo. Por favor, edítalo para que las cumpla. Mientras tanto, no elimines este aviso puesto el 6 de diciembre de 2009. También puedes… …   Wikipedia Español

• Disjoint union — In mathematics, the term disjoint union may refer to one of two different concepts: In set theory, a disjoint union (or discriminated union) is a modified union operation that indexes the elements according to which set they originated in;… …   Wikipedia

• Discriminated union — The term discriminated union may refer to: Disjoint union in set theory. Tagged union in computer science. This disambiguation page lists articles associated with the same title. If an internal link led you here …   Wikipedia

• Datenverbund — Ein Verbund (engl. object composition) ist ein aus Komponenten verschiedener Datentypen zusammengesetzter Datentyp. Da die Komponenten eines Verbunds wieder Verbünde sein können, können so auch komplexe Datenstrukturen definiert werden. Es gibt… …   Deutsch Wikipedia

• Struct — Ein Verbund (engl. object composition) ist ein aus Komponenten verschiedener Datentypen zusammengesetzter Datentyp. Da die Komponenten eines Verbunds wieder Verbünde sein können, können so auch komplexe Datenstrukturen definiert werden. Es gibt… …   Deutsch Wikipedia

• Verbund (Datentyp) — Ein Verbund (engl. object composition) ist ein aus Komponenten verschiedener Datentypen zusammengesetzter Datentyp. Da die Komponenten eines Verbunds wieder Verbünde sein können, können so auch komplexe Datenstrukturen definiert werden. Es gibt… …   Deutsch Wikipedia

• Algebraic data type — In computer programming, particularly functional programming and type theory, an algebraic data type (sometimes also called a variant type[1]) is a datatype each of whose values is data from other datatypes wrapped in one of the constructors of… …   Wikipedia