What are single and zero element tuples good for?

Question

C# 7.0 introduced value tuples and also some language level support for them. They added the support of single and zero element tuples as well; however, I could not find out any scenario when they could be useful.

By ValueTuple.Create overloads I can create any kind of tuples but the C# 7.0 syntax allows only at least two elements:

Microsoft (R) Roslyn C# Compiler version 2.8.3.62923
Loading context from 'CSharpInteractive.rsp'.
Type "#help" for more information.
> ValueTuple.Create()
[()]
> ValueTuple.Create(1)
[(1)]
> ValueTuple.Create(1, "x")
[(1, x)]

By tuple syntax:

> var t2 = (1, 2);
> var t1 = (1); // t1 is now int (of course)
> ValueTuple<int> t1 = (1);
(1,23): error CS0029: Cannot implicitly convert type 'int' to 'ValueTuple<int>'
> ValueTuple<int> t1 = new ValueTuple<int>(1);
> t1
[(1)]

I think I found the thread where this feature was requested but none of the code samples are valid in C# now and could not find any references in the planned features of C# 8.0 either, not even at the recursive tuple patterns.

In the request thread functional programming languages are mentioned. Is there maybe any functional language, which uses them now? I'm not an F# expert but its tuple reference does not mention any use of single and zero element tuples.

So the TL;DR questions:

• Are single and zero element tuples used in any (maybe functional) .NET language? I mean not by Tuple.Create or by the constructors but by native language support.
• Are they planned to used in a future version of C#?
• Or are they there for "just in case", for future compatibility?

Answer 1

What good is a 0-tuple?

A 2-tuple or a 3-tuple represent a group of related items. (Points in 2D space, RGB values of a color, etc.) A 1-tuple is not very useful since it could easily be replaced with a single int.

A 0-tuple seems even more useless since it contains absolutely nothing. Yet it has properties that make it very useful in functional languages like F#. For example, the 0-tuple type has exactly one value, usually represented as (). All 0-tuples have this value so it's essentially a singleton type. In most functional programming languages, including F#, this is called the unit type.

Functions that return void in C# will return the unit type in F#:

let printResult = printfn "Hello"

Run that in the F# interactive interpreter, and you'll see:

val printResult : unit = ()

This means that the value printResult is of type unit, and has the value () (the empty tuple, the one and only value of the unit type).

Functions can take the unit type as a parameter, too. In F#, functions may look like they're taking no parameters. But in fact, they're taking a single parameter of type unit. This function:

let doMath() = 2 + 4

is actually equivalent to:

let doMath () = 2 + 4

That is, a function that takes one parameter of type unit and returns the int value 6. If you look at the type signature that the F# interactive interpreter prints when you define this function, you'll see:

val doMath : unit -> int

The fact that all functions will take at least one parameter and return a value, even if that value is sometimes a "useless" value like (), means that function composition is a lot easier in F# than in languages that don't have the unit type. But that's a more advanced subject which we'll get to later on. For now, just remember that when you see unit in a function signature, or () in a function's parameters, that's the 0-tuple type that serves as the way to say "This function takes, or returns, no meaningful values."

Answer 2

I can't think of a use case for one element tuple. EDIT - As pointed out the referenced page mentions one element tuples as a way to name return parameters, which sounds actually useful, although this is probably C# specific.

Zero element tuple is in functional languages also known as unit. It's sort of equivalent of void in C#, which some (most?) functional languages don't have.

The difference is that () is an actual value, which you can do stuff with like hold a list of, pattern match etc. Functional languages need this because a function must return something and if you want to return "nothing" you have to do it explicitly by returning (). You can also write a function that accepts unit as a parameter, which basically means it's a value with delayed execution, most likely with side effects:

let x = getFromDb() // will read DB
stream.Flush() // will change state

Answer 3

There's no support for o-tuple (nople) an 1-tuple (oneple) in C#.

On the base class library (BCL), however, for coherence and just in case someone in the future finds a use for it, there is ValueTuple and ValueTuple<T>. For example, a language that has constructs for 0-tuple and 1-tuple.

ValueTuple has some added value. From the documentation:

The ValueTuple structure represents a tuple that has no elements. It is useful primarily for its static methods that let you create and compare instances of value tuple types. Its helper methods let you instantiate value tuples without having to explicitly specify the type of each value tuple component. By calling its static Create methods, you can create value tuples that have from zero to eight components. For value tuples with more than eight components, you must call the ValueTuple constructor.

Answer 4

At the moment, ValueTuple'1 is only used in representations of long tuples, even though there is no C# tuple syntax for 1-tuples: ValueTuple<T1, T2, T3, T4, T5, T6, T7, ValueTuple<T8>> is the underlying type for an 8-tuple.

As for 0-tuples and ValueTuple'0, we speculate they may appear in future scenarios (maybe some recursive patterns, if I recall correctly).

Answer 5

A 1-tuple can be used as a non-null wrapper around a nullable value. This useful when trying to add to a dictionary, for example:

void Process<TKey>(TKey[] keys)
{
    var dict = new Dictionary<TKey, Something>();
    var firstKey = keys[0];
    dict[firstKey] = new Something();
    ...
}

will show a warning if nullable is enabled (when creating dict), because TKey could be a nullable type (which the API may be willing to accept) and Dictionary<TKey, TValue> does not accept null ; while:

void Process<TKey>(TKey[] keys)
{
    var dict = new Dictionary<ValueTuple<TKey>, Something>();
    var firstKey = ValueTuple.Create(keys[0]);
    dict[firstKey] = new Something();
    ...
}

will not show the warning.

Answer 6

A 1-Tuple could be useful as a single parameter list of a delegate. Tuples are nice to use as delegate parameter lists, because you can change their structure and not break implementations of the delegate. Also you can name the parameters of the delegate this way. But since you can't use a 1-Tuple, you have to revert back to a regular parameter if the number of arguments changes to 1.

Eg:

int DoSomething(
   Func<(int First, int Second, int Third), int> function
) =>
   function((1, 2, 3));

// notice that you could add more parameters or change the order
// of the values and not break the lambda
DoSomething(args => 
   args.First + args.Second - args.Third
);

// DOESN'T WORK
int DoSomethingElse(
   Func<(int First), int> function
) =>
   function((1));

// does work but not as nice
int DoSomethingElse2(
   Func<int, int> function
) =>
   function(1);