Collections.Array2D Module (F#)
Basic operations on 2-dimensional arrays.
Namespace/Module Path: Microsoft.FSharp.Collections
Assembly: FSharp.Core (in FSharp.Core.dll)
module Array2D
Remarks
F# and CLI multi-dimensional arrays are typically zero-based. However, CLI multi-dimensional arrays used in conjunction with external libraries (for examples, libraries associated with Visual Basic) be non-zero based, using a potentially different base for each dimension. The operations in this module will accept such arrays, and the basing on an input array will be propagated to a matching output array on the Array2D.map and Array2D.mapi operations. Non-zero-based arrays can also be created using Array2D.zeroCreateBased, Array2D.createBased and Array2D.initBased.
Values
Value |
Description |
|---|---|
base1 : 'T [,] -> int |
Fetches the base-index for the first dimension of the array. |
base2 : 'T [,] -> int |
Fetches the base-index for the second dimension of the array. |
blit : 'T [,] -> int -> int -> 'T[,] -> int -> int -> int -> int -> unit |
Reads a range of elements from the first array and writes them into the second. |
copy : 'T [,] -> 'T [,] |
Creates a new array whose elements are the same as the input array. |
create : int -> int -> 'T -> 'T [,] |
Creates an array whose elements are all initially the given value. |
createBased : int -> int -> int -> int -> 'T -> 'T [,] |
Creates a based array whose elements are all initially the given value. |
get : 'T [,] -> int -> int -> 'T |
Fetches an element from a 2D array. You can also use the syntax array.[index1,index2]. |
init : int -> int -> (int -> int -> 'T) -> 'T [,] |
Creates an array given the dimensions and a generator function to compute the elements. |
initBased : int -> int -> int -> int -> (int -> int -> 'T) -> 'T [,] |
Creates a based array given the dimensions and a generator function to compute the elements. |
iter : ('T -> unit) -> 'T [,] -> unit |
Applies the given function to each element of the array. |
iteri: int -> int -> 'T -> unit |
Applies the given function to each element of the array. The integer indices passed to the function indicate the index of element. |
length1 : 'T [,] -> int |
Returns the length of an array in the first dimension. |
length2 : 'T [,] -> int |
Returns the length of an array in the second dimension. |
map : ('T -> 'U) -> 'T [,] -> 'U [,] |
Creates a new array whose elements are the results of applying the given function to each of the elements of the array. |
mapi : (int -> int -> 'T -> 'U) -> 'T [,] -> 'U [,] |
Creates a new array whose elements are the results of applying the given function to each of the elements of the array. The integer indices passed to the function indicate the element being transformed. |
rebase : 'T [,] -> 'T [,] |
Creates a new array whose elements are the same as the input array but where a non-zero-based input array generates a corresponding zero-based output array. |
set : 'T [,] -> int -> int -> 'T -> unit |
Sets the value of an element in an array. You can also use the syntax array.[index1,index2] <- value. |
zeroCreate : int -> int -> 'T [,] |
Creates an array where the entries are initially Unchecked.defaultof<'T>. |
zeroCreateBased : int -> int -> int -> int -> 'T [,] |
Creates a based array where the entries are initially Unchecked.defaultof<'T>. |
Platforms
Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2
Version Information
F# Core Library Versions
Supported in: 2.0, 4.0, Portable