I've just saw an unfamiliar syntax while looking for GroupBy
return type:
public interface IGrouping<out TKey, out TElement> : IEnumerable<TElement>
I know what does out
mean in methods, but not in a generics interface.
What does out
mean in a generic type?
It denotes a covariant parameter. See also the description on MSDN . Essentially it says, that IGrouping<Aderived, Bderived>
can be regarded as IGrouping<Abase, Bbase>
, hence you can
IGrouping<Aderived, Bderived> gr = MakeGrouping(...);
IGrouping<Abase, Bbase> grBase = gr;
if Aderived
is an interface or a type derived from Abase
. This is a feature that comes in handy when you want to call a method that requires a parameter of type IGrouping<Abase, Bbase>
, but you only got an object of type IGrouping<Aderived, Bderived>
. In this case, both types can be considered equivalent due to the covariance of their type parameters.
It is one of the two generic modifiers introduces in C# 4.0 (Visual Studio 2010).
It signifies that the generic parameter it is declared on is covariant.
The in
modifier signifies the generic parameter it is declared on is contravariant.
See out (Generic Modifier) and in (Generic Modifier) on MSDN.
out just means that the type is only used for output eg
public interface Foo<out T>
{
T Bar()
}
There also is a modifier in that means that the type is only used for input eg
public interface Foo<in T>
{
int Bar(T x)
}
These are used because Interfaces with in are covariant in T and Interfaces with out are contravariant in T.
out
keyword in this context would indicate the corresponding type parameter to be covariant simply speaking - covariance enables you to use a more derived type than that specified by the generic parameter.
BTW, see this ten part series from Eric Lippert to understand more about covariance and contra-variance: http://blogs.msdn.com/b/ericlippert/archive/2007/10/16/covariance-and-contravariance-in-c-part-one.aspx
The technical post webpages of this site follow the CC BY-SA 4.0 protocol. If you need to reprint, please indicate the site URL or the original address.Any question please contact:yoyou2525@163.com.