# Intersection type

In type theory, an intersection type can be allocated to values that can be assigned both the type ${\displaystyle \sigma }$ and the type ${\displaystyle \tau }$. This value can be given the intersection type ${\displaystyle \sigma \cap \tau }$ in an intersection type system.[1] Generally, if the ranges of values of two types overlap, then a value belonging to the intersection of the two ranges can be assigned the intersection type of these two types. Such a value can be safely passed as argument to functions expecting either of the two types. For example, in Java the class Boolean implements both the Serializable and the Comparable interfaces. Therefore, an object of type Boolean can be safely passed to functions expecting an argument of type Serializable and to functions expecting an argument of type Comparable.

Intersection types are composite data types. Similar to product types, they are used to assign several types to an object. However, product types are assigned to tuples, so that each tuple element is assigned a particular product type component. In comparison, underlying objects of intersection types are not necessarily composite. A restricted form of intersection types are refinement types.

Intersection types are useful for describing overloaded functions.[2] For example, if number => number is the type of function taking a number as an argument and returning a number, and string => string is the type of function taking a string as an argument and returning a string, then the intersection of these two types can be used to describe (overloaded) functions that do one or the other, based on what type of input they are given.

Contemporary programming languages, including Ceylon, Flow, Java, Scala, TypeSript, and Whiley (see comparison of languages with intersection types), use intersection types to combine interface specifications and to express ad hoc polymorphism. Complementing parametric polymorphism, intersection types may be used to avoid class hierarchy pollution from cross-cutting concerns and reduce boilerplate code, as shown in the TypeScript example below.

The type theoretic study of intersection types is referred to as the intersection type discipline.[3] Remarkably, program termination can be precisely characterized using intersection types.[4]

## TypeScript example

TypeScript supports intersection types,[5] improving expressivity of the type system and reducing potential class hierarchy size, demonstrated as follows.

The following program code defines the classes Chicken, Cow, and RandomNumberGenerator that each have a method produce returning an object of either type Egg, Milk, or number. Additionally, the function eatEgg (resp. drinkMilk) requires an object of type Egg (resp. Milk) as argument.

class Egg { private kind: "Egg" }
class Milk { private kind: "Milk" }

//produces eggs
class Chicken { produce() { return new Egg(); } }

//produces milk
class Cow { produce() { return new Milk(); } }

//produces a random number
class RandomNumberGenerator { produce() { return Math.random(); } }

//requires an egg
function eatEgg(egg: Egg) {
return "I ate an egg.";
}

//requires milk
function drinkMilk(milk: Milk) {
return "I drank some milk.";
}


The following program code defines the ad hoc polymorphic function animalToFood that invokes the member function produce of the given object animal. The function animalToFood has two type annotations, namely ((_: Chicken) => Egg) and ((_: Cow) => Milk), connected via the intersection type constructor &. Specifically, animalToFood when applied to an argument of type Chicken returns an object of type type Egg, and when applied to an argument of type Cow returns an object of type type Milk. Ideally, animalToFood should not be applicable to any object having (possibly by chance) a produce method.

//given a chicken, produces an egg; given a cow, produces milk
let animalToFood: ((_: Chicken) => Egg) & ((_: Cow) => Milk) =
function (animal: any) {
return animal.produce();
};


Finally, the following program code demonstrates type safe use of the above definitions.

 1 var chicken = new Chicken();
2 var cow = new Cow();
3 var randomNumberGenerator = new RandomNumberGenerator();
4
5 console.log(chicken.produce()); //Egg { }
6 console.log(cow.produce()); //Milk { }
7 console.log(randomNumberGenerator.produce()); //0.2626353555444987
8
9 console.log(animalToFood(chicken)); //Egg { }
10 console.log(animalToFood(cow)); //Milk { }
11 //console.log(animalToFood(randomNumberGenerator)); //ERROR: Argument of type 'RandomNumberGenerator' is not assignable to parameter of type 'Cow'
12
13 console.log(eatEgg(animalToFood(chicken))); //I ate an egg.
14 //console.log(eatEgg(animalToFood(cow))); //ERROR: Argument of type 'Milk' is not assignable to parameter of type 'Egg'
15 console.log(drinkMilk(animalToFood(cow))); //I drank some milk.
16 //console.log(drinkMilk(animalToFood(chicken))); //ERROR: Argument of type 'Egg' is not assignable to parameter of type 'Milk'


The above program code has the following properties:

• Lines 1-3 create objects chicken, cow, and randomNumberGenerator of their respective type.
• Lines 5-7 print for the previously created objects the respective results (provided as comments) when invoking produce.
• Line 9 (resp. 10) demonstrates type safe use of the method animalToFood applied to chicken (resp. cow).
• Line 11, if uncommitted, would result in a type error at compile time. Although the implementation of animalToFood could invoke the produce method of randomNumberGenerator, the type annotation of animalToFood disallows it. This is in accordance with the intended meaning of animalToFood.
• Line 13 (resp. 15) demonstrates that applying animalToFood to chicken (resp. cow) results in an object of type Egg (resp. Milk).
• Line 14 (resp. 16) demonstrates that applying animalToFood to cow (resp. chicken) does not result in an object of type Egg (resp. Milk). Therefore, if uncommented, line 14 (resp. 16) would result in a type error at compile time.

### Comparison to inheritance

The above minimalist example can be realized using inheritance, for instance by deriving the classes Chicken and Cow from a base class Animal. However, in a larger setting this could be disadvantageous. Introducing new classes into a class hierarchy is not necessarily justified for cross-cutting concerns, or may be outright impossible, for example when using an external library. Imaginably, the above example could be extended with the following classes:

• a class Horse that does not have a produce method;
• a class Sheep that has a produce method returning Wool;
• a class Pig that has a produce method, which can be used only once, returning Meat.

This may require additional classes (or interfaces) specifying whether a produce method is available, whether the produce method returns food, and whether the produce method can be used repeatedly. Overall, this may pollute the class hierarchy.

### Comparison to duck typing

The above minimalist example already shows that duck typing is less suited to realize the given scenario. While the class RandomNumberGenerator contains a produce method, the object randomNumberGenerator should not be a valid argument for animalToFood. The above example can be realized using duck typing, for instance by introducing a new field argumentForAnimalToFood to the classes Chicken and Cow signifying that objects of corresponding type are valid arguments for animalToFood. However, this would not only increase the size of the respective classes (especially with the introduction of more methods similar to animalToFood), but is also a non-local approach with respect to animalToFood.

The above example can be realized using function overloading, for instance by implementing two methods animalToFood(animal: Chicken): Egg and animalToFood(animal: Cow): Milk. In TypeScript, such a solution is almost identical to the provided example. Other programming languages, such as Java, require distinct implementations of the overloaded method. This may lead to either code duplication or boilerplate code.

### Comparison to the visitor pattern

The above example can be realized using the visitor pattern. It would require each animal class to implement an accept method accepting an object implementing the interface AnimalVisitor (adding non-local boilerplate code). The function animalToFood would be realized as the visit method of an implementation of AnimalVisitor. Unfortunately, the connection between the input type (Chicken or Cow) and the result type (Egg or Milk) would be difficult to represent.

### Limitations

On the one hand, intersection types can be used to locally annotate different types to a function without introducing new classes (or interfaces) to the class hierarchy. On the other hand, this approach requires all possible argument types and result types to be specified explicitly. If the behavior of a function can be specified precisely by either a unified interface, parametric polymorphism, or duck typing, then the verbose nature of intersection types is unfavorable. Therefore, intersection types should be considered complementary to existing specification methods.

## Dependent intersection type

A dependent intersection type, denoted ${\displaystyle (x:\sigma )\cap \tau }$ , is a dependent type in which the type ${\displaystyle \tau }$  may depend on the term variable ${\displaystyle x}$ .[6] In particular, if a term ${\displaystyle M}$  has the dependent intersection type ${\displaystyle (x:\sigma )\cap \tau }$ , then the term ${\displaystyle M}$  has both the type ${\displaystyle \sigma }$  and the type ${\displaystyle \tau [x:=M]}$ , where ${\displaystyle \tau [x:=M]}$  is the type which results from replacing all occurrences of the term variable ${\displaystyle x}$  in ${\displaystyle \tau }$  by the term ${\displaystyle M}$ .

### Scala example

Scala supports type declarations [7] as object members. This allows a type of an object member to depend on the value of another member, which is called a path-dependent type.[8] For example, the following program text defines a Scala trait Witness, which can be used to implement the singleton pattern.[9]

trait Witness {
type T
val value: T {}
}


The above trait Witness declares the member T, which can be assigned a type as its value, and the member value, which can be assigned a value of type T. The following programm text defines an object booleanWitness as instance of the above trait Witness. The object booleanWitness defines the type T as Boolean and the value value as true. For example, executing System.out.println(booleanWitness.value) prints true on the console.

object booleanWitness extends Witness {
type T = Boolean
val value = true
}


Let ${\displaystyle \langle {\textsf {x}}:\sigma \rangle }$  be the type (specifically, a record type) of objects having the member ${\displaystyle {\textsf {x}}}$  of type ${\displaystyle \sigma }$ . In the above example, the object booleanWitness can be assigned the dependent intersection type ${\displaystyle (x:\langle {\textsf {T}}:{\text{Type}}\rangle )\cap \langle {\textsf {value}}:x.{\textsf {T}}\rangle }$ . The reasoning is as follows. The object booleanWitness has the member T that is assigned the type Boolean as its value. Since Boolean is a type, the object booleanWitness has the type ${\displaystyle \langle {\textsf {T}}:{\text{Type}}\rangle }$ . Additionally, the object booleanWitness has the member value that is assigned the value true of type Boolean. Since the value of booleanWitness.T is Boolean, the object booleanWitness has the type ${\displaystyle \langle {\textsf {value}}:{\textsf {booleanWitness.T}}\rangle }$ . Overall, the object booleanWitness has the intersection type ${\displaystyle \langle {\textsf {T}}:{\text{Type}}\rangle \cap \langle {\textsf {value}}:{\textsf {booleanWitness.T}}\rangle }$ . Therefore, presenting self-reference as dependency, the object booleanWitness has the dependent intersection type ${\displaystyle (x:\langle {\textsf {T}}:{\text{Type}}\rangle )\cap \langle {\textsf {value}}:x.{\textsf {T}}\rangle }$ .

Alternatively, the above minimalistic example can be described using dependent record types.[10] In comparison to dependent intersection types, dependent record types constitute a strictly more specialized type theoretic concept.[6]

## Intersection of a type family

An intersection of a type family, denoted ${\displaystyle \bigcap _{x:\sigma }\tau }$ , is a dependent type in which the type ${\displaystyle \tau }$  may depend on the term variable ${\displaystyle x}$ .[6] In particular, if a term ${\displaystyle M}$  has the type ${\displaystyle \bigcap _{x:\sigma }\tau }$ , then for each term ${\displaystyle N}$  of type ${\displaystyle \sigma }$ , the term ${\displaystyle M}$  has the type ${\displaystyle \tau [x:=N]}$ . This notion is also called implicit Pi type,[11] observing that the argument ${\displaystyle N}$  is not kept at term level.

## Comparison of languages with intersection types

Language Actively developed Paradigm(s) Status Features
C# Yes[12] Under discussion[13] ?
Ceylon Yes[14] Supported[15]
• Type refinement
• Interface composition
• Subtyping in width
F# Yes[16] Under discussion[17] ?
Flow Yes[18] Supported[19]
• Type refinement
• Interface composition
Forsythe No Supported[20]
• Function type intersection
• Distributive, co- and contravariant function type subtyping
Java Yes[21] Supported[22]
• Type refinement
• Interface composition
• Subtyping in width
Scala Yes[23] Supported[24][25]
• Type refinement
• Trait composition
• Subtyping in width
TypeScript Yes[26] Supported[5]
• Arbitrary type intersection
• Interface composition
• Subtyping in width and depth
Whiley Yes[27] Supported[28] ?

## References

1. ^ Barendregt, Henk; Coppo, Mario; Dezani-Ciancaglini, Mariangiola (1983). "A filter lambda model and the completeness of type assignment". Journal of Symbolic Logic. 48 (4): 931–940. doi:10.2307/2273659. JSTOR 2273659.
2. ^ Palsberg, Jens (2012). "Overloading is NP-Complete". Logic and Program Semantics. Lecture Notes in Computer Science. 7230. pp. 204–218. doi:10.1007/978-3-642-29485-3_13. ISBN 978-3-642-29484-6.
3. ^ Henk Barendregt; Wil Dekkers; Richard Statman (20 June 2013). Lambda Calculus with Types. Cambridge University Press. pp. 1–. ISBN 978-0-521-76614-2.
4. ^ Ghilezan, Silvia (1996). "Strong normalization and typability with intersection types". Notre Dame Journal of Formal Logic. 37 (1): 44–52. doi:10.1305/ndjfl/1040067315.
5. ^ a b "Intersection Types in TypeScript". Retrieved 2019-08-01.
6. ^ a b c Kopylov, Alexei (2003). "Dependent intersection: A new way of defining records in type theory". 18th IEEE Symposium on Logic in Computer Science. LICS 2003. IEEE Computer Society. pp. 86–95. CiteSeerX 10.1.1.89.4223. doi:10.1109/LICS.2003.1210048.
7. ^ "Type declarations in Scala". Retrieved 2019-08-15.
8. ^ Amin, Nada; Grütter, Samuel; Odersky, Martin; Rompf, Tiark; Stucki, Sandro (2016). "The essence of dependent object types". A List of Successes That Can Change the World - Essays Dedicated to Philip Wadler on the Occasion of His 60th Birthday. Lecture Notes in Computer Science. 9600. Springer. pp. 249–272. doi:10.1007/978-3-319-30936-1_14.
9. ^ "Singletons in the Scala shapeless library". Retrieved 2019-08-15.
10. ^ Pollack, Robert (2000). "Dependently typed records for representing mathematical structure". Theorem Proving in Higher Order Logics, 13th International Conference. TPHOLs 2000. Springer. pp. 462–479. doi:10.1007/3-540-44659-1_29.
11. ^ Stump, Aaron (2018). "From realizability to induction via dependent intersection". Annals of Pure and Applied Logic. 169 (7): 637–655. doi:10.1016/j.apal.2018.03.002.
12. ^ "C# Guide". Retrieved 2019-08-08.
13. ^ "Discussion: Union and Intersection types in C Sharp". Retrieved 2019-08-08.
14. ^ "Eclipse Ceylon: Welcom to Ceylon". Retrieved 2019-08-08.
15. ^ "Intersection Types in Ceylon". Retrieved 2019-08-08.
16. ^ "F# Software Foundation". Retrieved 2019-08-08.
17. ^ "Add Intersection Types to F Sharp". Retrieved 2019-08-08.
18. ^ "Flow: A Static Type Checker for JavaScript". Retrieved 2019-08-08.
19. ^ "Intersection Type Syntax in Flow". Retrieved 2019-08-08.
20. ^ Reynolds, J. C. (1988). Preliminary design of the programming language Forsythe.
21. ^ "Java Software". Retrieved 2019-08-08.
22. ^ "IntersectionType (Java SE 12 & JDK 12)". Retrieved 2019-08-01.
23. ^ "The Scala Programming Language". Retrieved 2019-08-08.
24. ^ "Compound Types in Scala". Retrieved 2019-08-01.
25. ^ "Intersection Types in Dotty". Retrieved 2019-08-01.
26. ^ "TypeScript - JavaScript that scales". Retrieved 2019-08-01.
27. ^ "Whiley: an Open Source Programming Language with Extended Static Checking". Retrieved 2019-08-01.
28. ^ "Whiley language specification" (PDF). Retrieved 2019-08-01.