ResizeArray 0.18.0

ResizeArray

ResizeArray is an F# extension and module library for ResizeArray<'T> ( = Collection.Generic.List<'T>)

It also works with Fable.

It Includes:

• A ResizeArray module that has a corresponding functions for all functions in the Array module from FSharp.Core. Including those for parallel computing.

• A Computational Expressions resizeArray that can be used like existing ones for seq.

• Support for F# slicing operator and indexing from the end. e.g: items.[ 1 .. ^1]

• Extension members on ResizeArray like .Get .Set .First .Last .SecondLast and more. With nicer IndexOutOfRangeExceptions that include the bad index and the actual size.

• All Tests from the from FSharp.Core's Array module ported and adapted to run in both javascript and dotnet.

Usage

Just open the namespace

open ResizeArray

this namespace contains:

• a module also called ResizeArray
• a Computational Expressions called resizeArray
• this will also auto open the extension members on ResizeArray<'T>

then you can do:

let evenNumbers =
    resizeArray {  // a Computational Expressions like seq
        for i = 0 t 99 do
            if i % 2 = 0 then
                i
    }

let oddNumbers = evenNumbers |> ResizeArray.map (fun x -> x + 1) // ResizeArray module

let hundred = oddNumbers.Last // Extension member to access the last item in list

Why ?

Yes, F# Arrays and (linked) Lists can do these kind of operations on collections too. But ResizeArray (being mutable) still offers the best performance for collections that expand or shrink and need random access.

In fact FSharp.Core uses a very similar module internally

License

MIT

Test

All Tests from the from FSharp.Core's Array module ported and adapted to run in both javascript and dotnet. go to the tests folder

cd Tests

For testing with .NET using Expecto run

dotnet run

for testing with Fable.Mocha run

npm test

Changelog

0.18.0

• add mapToArray
• add failIfEmpty

0.17.0

• don't fail on LastIndex when empty

0.16.0

• add null checks
• add 'partitionBy' functions
• add equality checks for nested ResizeArrays
• flip arg order of 'sub' function

0.15.0

• implementation ported from Rarr type in https://github.com/goswinr/FsEx/blob/main/Src/RarrModule.fs