summaryrefslogtreecommitdiff
path: root/src/mscorlib/src/System/Collections/Generic/IEnumerable.cs
diff options
context:
space:
mode:
Diffstat (limited to 'src/mscorlib/src/System/Collections/Generic/IEnumerable.cs')
-rw-r--r--src/mscorlib/src/System/Collections/Generic/IEnumerable.cs58
1 files changed, 58 insertions, 0 deletions
diff --git a/src/mscorlib/src/System/Collections/Generic/IEnumerable.cs b/src/mscorlib/src/System/Collections/Generic/IEnumerable.cs
new file mode 100644
index 0000000000..e3ab70ea40
--- /dev/null
+++ b/src/mscorlib/src/System/Collections/Generic/IEnumerable.cs
@@ -0,0 +1,58 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+/*============================================================
+**
+** Interface: IEnumerable
+**
+**
+**
+**
+** Purpose: Interface for providing generic IEnumerators
+**
+**
+===========================================================*/
+namespace System.Collections.Generic {
+ using System;
+ using System.Collections;
+ using System.Runtime.InteropServices;
+ using System.Runtime.CompilerServices;
+ using System.Diagnostics.Contracts;
+
+ // Implement this interface if you need to support foreach semantics.
+
+ // Note that T[] : IList<T>, and we want to ensure that if you use
+ // IList<YourValueType>, we ensure a YourValueType[] can be used
+ // without jitting. Hence the TypeDependencyAttribute on SZArrayHelper.
+ // This is a special workaround internally though - see VM\compile.cpp.
+ // The same attribute is on IList<T> and ICollection<T>.
+ [TypeDependencyAttribute("System.SZArrayHelper")]
+#if CONTRACTS_FULL
+ [ContractClass(typeof(IEnumerableContract<>))]
+#endif // CONTRACTS_FULL
+ public interface IEnumerable<out T> : IEnumerable
+ {
+ // Returns an IEnumerator for this enumerable Object. The enumerator provides
+ // a simple way to access all the contents of a collection.
+ /// <include file='doc\IEnumerable.uex' path='docs/doc[@for="IEnumerable.GetEnumerator"]/*' />
+ new IEnumerator<T> GetEnumerator();
+ }
+
+#if CONTRACTS_FULL
+ [ContractClassFor(typeof(IEnumerable<>))]
+ internal abstract class IEnumerableContract<T> : IEnumerable<T>
+ {
+ [Pure]
+ IEnumerator<T> IEnumerable<T>.GetEnumerator()
+ {
+ Contract.Ensures(Contract.Result<IEnumerator<T>>() != null);
+ return default(IEnumerator<T>);
+ }
+
+ IEnumerator IEnumerable.GetEnumerator()
+ {
+ return default(IEnumerator);
+ }
+ }
+#endif // CONTRACTS_FULL
+}