Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

What does an empty set of parentheses mean when used in a generic type declaration?

Tags:

rust

The Display trait is defined as follows:

pub trait Display {     fn fmt(&self, &mut Formatter) -> Result<(), Error>; } 

The most mysterious thing to me is the empty set of parentheses, (), in the type declaration Result<(), Error>. What is it and its purpose?

like image 742
w.brian Avatar asked Jun 29 '15 04:06

w.brian


1 Answers

() is an empty tuple, a simple zero-sized type (it uses no memory) with only one value possible, (). It’s also known as the unit type. Its use in a return type of Result<(), E> means “if nothing goes wrong, there’s no further value produced”. The semantics are what’s important—the call was OK.

Result<(), ()> would also make sense as a return type—either something succeeded, or it failed, with nothing more to report in either case.

like image 64
Chris Morgan Avatar answered Oct 05 '22 13:10

Chris Morgan