CLSS.ExtensionMethods.IEnumerable.Looping
1.1.1
dotnet add package CLSS.ExtensionMethods.IEnumerable.Looping --version 1.1.1
NuGet\Install-Package CLSS.ExtensionMethods.IEnumerable.Looping -Version 1.1.1
<PackageReference Include="CLSS.ExtensionMethods.IEnumerable.Looping" Version="1.1.1" />
paket add CLSS.ExtensionMethods.IEnumerable.Looping --version 1.1.1
#r "nuget: CLSS.ExtensionMethods.IEnumerable.Looping, 1.1.1"
// Install CLSS.ExtensionMethods.IEnumerable.Looping as a Cake Addin
#addin nuget:?package=CLSS.ExtensionMethods.IEnumerable.Looping&version=1.1.1
// Install CLSS.ExtensionMethods.IEnumerable.Looping as a Cake Tool
#tool nuget:?package=CLSS.ExtensionMethods.IEnumerable.Looping&version=1.1.1
CLSS.ExtensionMethods.IEnumerable.Looping
Problem
Looping a collection indefinitely is an operation that maps well to many use cases (such as AI behavior phases, sequentially looping slideshow, infinite scrolling background, etc...). And while the CLSS package IEnumerator.LoopNext
provided a solution for this problem with wide compatibility, its approach may not suit every situation.
IEnumerator.LoopNext
works on enumerators which are inherently stateful and mutable. It may be enough when you are not particularly concerned about where the enumerator is at in the collection and just want to fetch the next looping element in line one at a time. But when you know the content of the collection, you know where you want to start the loop and how many times you want to take from it all at once, there is some verbosity that can be cut down.
Solution
Looping
is an extension method for all IEnumerable
and IEnumerable<T>
types that returns an enumerable that loops infinitely in the forward-moving direction on a collection. The enumerable returned by this method loops infinitely just by calling the standard method MoveNext
. Therefore, a foreach
statement of it can also iterate infinitely.
using CLSS;
var numbers = new int[] { 0, 1, 2, 3 };
var loopingNumbers = numbers.Looping();
foreach (var number in loopingNumbers)
{
// this will never stop running until it reaches a break statement
}
As a result of a never-ending MoveNext
and the immutability of LINQ methods, controlling where and how much you want to run over a loop can be done as succint as this:
using CLSS;
using System.Linq;
var numbers = new int[] { 0, 1, 2, 3 };
foreach (var number in numbers.Looping().Skip(1).Take(6))
{
// this will enumerate 1, 2, 3, 0, 1, 2 then conclude the foreach statement
}
If a looping enumerable was created out of an empty collection, iterating over it is also no different than iterating an empty collection.
var emptyArr = new int[0];
foreach (var number in emptyArr.Looping())
{
// Unreachable code
}
The looping enumerable returned by Looping
should be handled with care. Methods that would cause a full enumeration such as LINQ ToArray
, ToList
or Count
will freeze up a C# program due to infinite enumeration, unless you have limited the enumeration range first with Take
. Note that TakeLast
is also a full-enumeration method.
This package is a part of the C# Language Syntactic Sugar suite.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp1.0 was computed. netcoreapp1.1 was computed. netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard1.0 is compatible. netstandard1.1 was computed. netstandard1.2 was computed. netstandard1.3 was computed. netstandard1.4 was computed. netstandard1.5 was computed. netstandard1.6 was computed. netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net45 was computed. net451 was computed. net452 was computed. net46 was computed. net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen30 was computed. tizen40 was computed. tizen60 was computed. |
Universal Windows Platform | uap was computed. uap10.0 was computed. |
Windows Phone | wp8 was computed. wp81 was computed. wpa81 was computed. |
Windows Store | netcore was computed. netcore45 was computed. netcore451 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 1.0
- CLSS.ExtensionMethods.IEnumerator.LoopNext (>= 1.0.1)
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 2.0
- CLSS.ExtensionMethods.IEnumerator.LoopNext (>= 1.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
- Added language-sensitive syntax highlighting in README file.