ArrayExtensions 1.2.7

There is a newer version of this package available.
See the version list below for details.

dotnet add package ArrayExtensions --version 1.2.7

NuGet\Install-Package ArrayExtensions -Version 1.2.7

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="ArrayExtensions" Version="1.2.7" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add ArrayExtensions --version 1.2.7

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: ArrayExtensions, 1.2.7"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install ArrayExtensions as a Cake Addin
#addin nuget:?package=ArrayExtensions&version=1.2.7

// Install ArrayExtensions as a Cake Tool
#tool nuget:?package=ArrayExtensions&version=1.2.7

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

ArrayExtensions

A collection of extension methods for arrays in C#.

Installation 🔧

Install via NuGet:

Install-Package ArrayExtensions

Or just copy whatever you need from this repository 😃

Features ⭐

Generic Array methods

Name	Description
`Add<T>()`, `AddRange<T>()`	Appends single or multiple items to the end of an array.
`AllEqual<T>()`	Checks if all elements in an array are identical.
`AnyNull<T>()`	Determines if any element in an array of reference types is null.
`BinarySearch<T>()`	Performs a binary search on a sorted array.
`CountOf<T>()`	Counts occurrences of a specific item in the array.
`Chunk<T>()`	Divides an array into smaller arrays of a specified maximum size.
`DeepCopy<T>()`	Creates a deep copy of an array, where elements implement ICloneable.
`DistinctBy<T, TKey>()`	Returns distinct elements based on a specified selector function.
`DistinctValues<T>()`	Returns distinct values from the array.
`FindIndices<T>()`	Finds indices of all elements that match a given predicate.
`Flatten<T>()`	Flattens a multi-dimensional array into a single-dimensional array.
`ForEach<T>()`	Executes an action on each element of an array.
`IsEmpty<T>()`, `IsNullOrEmpty<T>()`	Check if an array is empty or null/empty, respectively.
`Interleave<T>()`	Interleaves elements of two arrays into a single array.
`InsertAt<T>()`	Inserts an element at a specified index.
`Shuffle<T>()`	Randomly shuffles the elements of an array.
`MostCommon<T>()`	Finds the most common element in the array.
`MaxBy<T, TKey>() and MinBy<T, TKey>()`	Finds the maximum/minimum element based on a specified selector function.
`RandomSample<T>()`	Selects a random sample of elements.
`RemoveNulls<T>()`	Removes all null items from an array of reference types.
`RemoveAt<T>()`	Removes the element at a specified index.
`ReplaceAll<T>()`	Replaces all occurrences of a specific value with another in the array.
`Resize<T>()`	Resizes an array to a specified new size.
`RotateLeft<T>()`, `RotateRight<T>()`	Rotates the array left or right by a specified number of positions.
`SafeGet<T>()`	Retrieves an element at a specified index or a default value if out of range.
`SafeSet<T>()`	Sets a value at a specified index, resizing the array if necessary.
`Segment<T>()`	Splits an array into segments based on a predicate.
`SequentialPairs<T>()`	Generates a sequence of tuples from sequential pairs of elements.
`Slice<T>()`	Returns a portion of the array, similar to substring for strings.
`Tail<T>()`, `Head<T>()`, `LastN<T>()`, `FirstN<T>()`	Provide various ways to slice and access elements.

DateTime Array methods

Name	Description
`AllInFuture`	Checks if all dates in the array are in the future.
`AllInPast`	Checks if all dates in the array are in the past.
`BusinessDaysCount`	Calculates the number of business days between the earliest and latest date in the array.
`ClosestTo`	Gets the closest date to a specified reference date.
`DateRange`	Gets the range between the earliest and latest date.
`EarliestDate`	Finds and returns the earliest date present in the array.
`EquidistantDates`	Finds dates that are equidistant from a given reference date.
`FilterByDateRange`	Filters dates that fall within a specified date range.
`FilterHolidays`	Filters dates that match a provided list of holidays.
`FilterLastDayOfWeek`	Filters dates that fall on the last specific day of the week of their month.
`FilterNthDayOfWeek`	Filters dates that are the nth occurrence of a specified day of the week in their month.
`FilterWeekdays`	Filters dates that are weekdays (Monday to Friday).
`FilterWeekends`	Filters dates that are weekends (Saturday or Sunday).
`GroupByDay`	Groups dates by day.
`GroupByDayOfWeek`	Groups dates by their day of the week.
`GroupByMonth`	Groups dates by month.
`GroupByYear`	Groups dates by year.
`LatestDate`	Finds and returns the latest date present in the array.

String Array methods

Name	Description
`AllOfLength`	Checks if all strings in the array are of a specified length.
`AggregateStrings`	Aggregates the array into a single string using a specified function.
`AnyNullOrEmpty`	Checks if any string in the array is null or empty.
`AnyNullOrWhiteSpace`	Checks if any string in the array is null or whitespace.
`CapitalizeFirstLetter`	Capitalizes the first letter of each string in the array.
`ConcatenateWithSeparator`	Concatenates all strings in the array with a given separator.
`ContainsSubstring`	Checks if any of the strings in the array contains a specified substring.
`CountOccurrencesOfSubstring`	Counts occurrences of a specific substring in all strings of the array.
`CountStringsMatchingPattern`	Counts the number of strings that match a regular expression pattern.
`EndsWithSubstring`	Checks if any of the strings in the array ends with a specified substring.
`FilterByPattern`	Filters strings that match a given regular expression pattern.
`HasDuplicates`	Checks if the array contains any duplicate strings.
`JoinNonEmpty`	Concatenates non-empty strings in the array with a given separator.
`LongestString`	Retrieves the longest string from the array.
`NormalizeWhitespace`	Replaces multiple consecutive whitespace characters in each string with a single space.
`RemoveNullOrEmpty`	Removes all null or empty strings from the array.
`RemoveNullOrWhiteSpace`	Removes all null, empty, or whitespace strings from the array.
`ReplaceInAll`	Replaces a specified substring in all strings of the array.
`ReverseEach`	Reverses each string in the array.
`SortAlphabetically`	Sorts the array of strings in alphabetical order.
`StartsWithSubstring`	Checks if any of the strings in the array starts with a specified substring.
`ShortestString`	Retrieves the shortest string from the array.
`ToLowerCase`	Converts all strings in the array to lowercase.
`ToUpperCase`	Converts all strings in the array to uppercase.
`TrimAll`	Trims whitespace from all strings in the array.
`UniqueStrings`	Returns an array of unique strings, removing duplicates..

Integer Array methods

Name	Description
`AverageIgnoringZero`	Calculates the average of the elements in the array, ignoring zero values.
`FindPrimeNumbers`	Filters the array to include only prime numbers.
`IsMonotonicallyIncreasing`	Checks if the array's elements are in a strictly increasing order.
`IsMonotonicallyDecreasing`	Checks if the array's elements are in a strictly decreasing order.
`MultiplyAll`	Multiplies all elements in the array and returns the product.
`Mode`	Finds the most frequently occurring number(s) in the array.
`Percentile`	Finds the percentile value in the array.
`Randomize`	Randomizes the order of elements in the array.
`StandardDeviation`	Calculates the standard deviation of the array elements.
`SumAbsoluteDifferences`	Calculates the sum of the absolute differences between all pairs of elements.
`SumEvenNumbers`	Sums all the even numbers in the array.
`SumOddNumbers`	Sums all the odd numbers in the array.
`ToFrequencyMap`	Creates a frequency map (count of each element).
`Variance`	Calculates the variance of the array elements.

License

MIT

Product	Compatible and additional computed target framework versions.
.NET	net6.0 is compatible. 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.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net6.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.

Version	Downloads	Last updated
1.3.0	244	12/16/2023
1.2.7	79	12/13/2023
1.2.5	75	12/13/2023
1.2.1	113	10/10/2023
1.2.0	87	10/9/2023
1.1.0	91	10/3/2023
1.0.0	97	10/3/2023