CLSS.ExtensionMethods.IList.GetLoopingElementAt
1.0.1
dotnet add package CLSS.ExtensionMethods.IList.GetLoopingElementAt --version 1.0.1
NuGet\Install-Package CLSS.ExtensionMethods.IList.GetLoopingElementAt -Version 1.0.1
<PackageReference Include="CLSS.ExtensionMethods.IList.GetLoopingElementAt" Version="1.0.1" />
paket add CLSS.ExtensionMethods.IList.GetLoopingElementAt --version 1.0.1
#r "nuget: CLSS.ExtensionMethods.IList.GetLoopingElementAt, 1.0.1"
// Install CLSS.ExtensionMethods.IList.GetLoopingElementAt as a Cake Addin
#addin nuget:?package=CLSS.ExtensionMethods.IList.GetLoopingElementAt&version=1.0.1
// Install CLSS.ExtensionMethods.IList.GetLoopingElementAt as a Cake Tool
#tool nuget:?package=CLSS.ExtensionMethods.IList.GetLoopingElementAt&version=1.0.1
CLSS.ExtensionMethods.IList.GetLoopingElementAt
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, some limitation has to be in place for the sake of compatibility. It can only loop an enumerator in the ascending order, as is the nature of enumeration.
With IList
and IList<T>
types, we have more information to work with. Use cases for looping in descending order emerge and are not addressed by IEnumerator.LoopNext
. Writing descending loop by hand is not as obvious as it may sound and can stump your train of thought.
using CLSS;
var numbers = new int[] { 0, 1, 2, 3 };
// Take arbitrary number in a descending loop
int takeNumber = 10;
foreach (int i = 0; i > -takeNumber; --i)
{
// this is a correct solution, but may stump you just by reading
int resolvedIndex = ((i % numbers.Length) + numbers.Length) % numbers.Length;
DoSomethingWith(numbers[resolvedIndex]);
}
Solution
GetLoopingElementAt
is an extension method for all Ilist
and IList<T>
types that resolves a integer number it takes in as a cyclic index number and returns the element at the resulting index. By spelling out what it's doing on the method name, it gives you a better code comprehension.
using CLSS;
var numbers = new int[] { 0, 1, 2, 3 };
numbers.GetLoopingElementAt(-1); // returns 3
numbers.GetLoopingElementAt(5); // returns 1
GetLoopingElementAt
resolves positive and negative numbers into a valid index. Looping over a list is as simple as picking a starting point and go as low or high as you want. Increment to loop the list in ascending order, decrement to loop the list in descending order.
This package also comes with a ResolveLoopingIndex
extension method to only receive the result of cyclically resolving a number into a valid index of the source list.
Note: GetLoopingElementAt
and ResolveLoopingIndex
work on all types implementing the IList<T>
interface, including raw C# array.
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
- NETStandard.Library (>= 1.6.1)
-
.NETStandard 2.0
- No dependencies.
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.