This class serves as a wrapper for Array
s with many of the operations found in indexed sequences. Where needed, instances of arrays are implicitly converted into this class. There is generally no reason to create an instance explicitly or use an ArrayOps
type. It is better to work with plain Array
types instead and rely on the implicit conversion to ArrayOps
when calling a method (which does not actually allocate an instance of ArrayOps
because it is a value class).
Neither Array
nor ArrayOps
are proper collection types (i.e. they do not extend Iterable
or even IterableOnce
). mutable.ArraySeq
and immutable.ArraySeq
serve this purpose.
The difference between this class and ArraySeq
s is that calling transformer methods such as filter
and map
will yield an array, whereas an ArraySeq
will remain an ArraySeq
.
Type parameters
- A
-
type of the elements contained in this array.
Attributes
- Companion
- object
- Source
- ArrayOps.scala
- Graph
-
- Supertypes
Members list
Value members
Concrete methods
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
A copy of this array with an element appended.
A copy of this array with all elements of a collection appended.
A copy of this array with all elements of an array appended.
Builds a new array by applying a partial function to all elements of this array on which the function is defined.
Builds a new array by applying a partial function to all elements of this array on which the function is defined.
Type parameters
- B
-
the element type of the returned array.
Value parameters
- pf
-
the partial function which filters and maps the array.
Attributes
- Returns
-
a new array resulting from applying the given partial function
pf
to each element on which it is defined and collecting the results. The order of the elements is preserved. - Source
- ArrayOps.scala
Finds the first element of the array for which the given partial function is defined, and applies the partial function to it.
Finds the first element of the array for which the given partial function is defined, and applies the partial function to it.
Attributes
- Source
- ArrayOps.scala
Iterates over combinations of elements.
Iterates over combinations of elements.
A combination of length n
is a sequence of n
elements selected in order of their first index in this sequence.
For example, "xyx"
has two combinations of length 2. The x
is selected first: "xx"
, "xy"
. The sequence "yx"
is not returned as a combination because it is subsumed by "xy"
.
If there is more than one way to generate the same combination, only one will be returned.
For example, the result "xy"
arbitrarily selected one of the x
elements.
As a further illustration, "xyxx"
has three different ways to generate "xy"
because there are three elements x
to choose from. Moreover, there are three unordered pairs "xx"
but only one is returned.
It is not specified which of these equal combinations is returned. It is an implementation detail that should not be relied on. For example, the combination "xx"
does not necessarily contain the first x
in this sequence. This behavior is observable if the elements compare equal but are not identical.
As a consequence, "xyx".combinations(3).next()
is "xxy"
: the combination does not reflect the order of the original sequence, but the order in which elements were selected, by "first index"; the order of each x
element is also arbitrary.
Attributes
- Returns
-
An Iterator which traverses the n-element combinations of this array
- Example
-
Array('a', 'b', 'b', 'b', 'c').combinations(2).map(runtime.ScalaRunTime.stringOf).foreach(println) // Array(a, b) // Array(a, c) // Array(b, b) // Array(b, c) Array('b', 'a', 'b').combinations(2).map(runtime.ScalaRunTime.stringOf).foreach(println) // Array(b, b) // Array(b, a)
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Tests whether this array contains a given value as an element.
Tests whether this array contains a given value as an element.
Value parameters
- elem
-
the element to test.
Attributes
- Returns
-
true
if this array has an element that is equal (as determined by==
) toelem
,false
otherwise. - Source
- ArrayOps.scala
Copy elements of this array to another array.
Copy elements of this array to another array. Fills the given array xs
starting at index 0. Copying will stop once either all the elements of this array have been copied, or the end of the array is reached.
Type parameters
- B
-
the type of the elements of the array.
Value parameters
- xs
-
the array to fill.
Attributes
- Source
- ArrayOps.scala
Copy elements of this array to another array.
Copy elements of this array to another array. Fills the given array xs
starting at index start
. Copying will stop once either all the elements of this array have been copied, or the end of the array is reached.
Type parameters
- B
-
the type of the elements of the array.
Value parameters
- start
-
the starting index within the destination array.
- xs
-
the array to fill.
Attributes
- Source
- ArrayOps.scala
Copy elements of this array to another array.
Copy elements of this array to another array. Fills the given array xs
starting at index start
with at most len
values. Copying will stop once either all the elements of this array have been copied, or the end of the array is reached, or len
elements have been copied.
Type parameters
- B
-
the type of the elements of the array.
Value parameters
- len
-
the maximal number of elements to copy.
- start
-
the starting index within the destination array.
- xs
-
the array to fill.
Attributes
- Source
- ArrayOps.scala
Counts the number of elements in this array which satisfy a predicate
Counts the number of elements in this array which satisfy a predicate
Attributes
- Source
- ArrayOps.scala
Computes the multiset difference between this array and another sequence.
Computes the multiset difference between this array and another sequence.
Value parameters
- that
-
the sequence of elements to remove
Attributes
- Returns
-
a new array which contains all elements of this array except some of occurrences of elements that also appear in
that
. If an element valuex
appears n times inthat
, then the first n occurrences ofx
will not form part of the result, but any following occurrences will. - Source
- ArrayOps.scala
Selects all the elements of this array ignoring the duplicates.
Selects all the elements of this array ignoring the duplicates.
Attributes
- Returns
-
a new array consisting of all the elements of this array without duplicates.
- Source
- ArrayOps.scala
Selects all the elements of this array ignoring the duplicates as determined by ==
after applying the transforming function f
.
Selects all the elements of this array ignoring the duplicates as determined by ==
after applying the transforming function f
.
Type parameters
- B
-
the type of the elements after being transformed by
f
Value parameters
- f
-
The transforming function whose result is used to determine the uniqueness of each element
Attributes
- Returns
-
a new array consisting of all the elements of this array without duplicates.
- Source
- ArrayOps.scala
The rest of the array without its n
first elements.
The rest of the array without its n
last elements.
Drops longest prefix of elements that satisfy a predicate.
Drops longest prefix of elements that satisfy a predicate.
Value parameters
- p
-
The predicate used to test elements.
Attributes
- Returns
-
the longest suffix of this array whose first element does not satisfy the predicate
p
. - Source
- ArrayOps.scala
Tests whether this array ends with the given array.
Tests whether this array ends with the given array.
Value parameters
- that
-
the array to test
Attributes
- Returns
-
true
if this array hasthat
as a suffix,false
otherwise. - Source
- ArrayOps.scala
Tests whether this array ends with the given sequence.
Tests whether this array ends with the given sequence.
Value parameters
- that
-
the sequence to test
Attributes
- Returns
-
true
if this array hasthat
as a suffix,false
otherwise. - Source
- ArrayOps.scala
Tests whether a predicate holds for at least one element of this array.
Tests whether a predicate holds for at least one element of this array.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
true
if the given predicatep
is satisfied by at least one element of this array, otherwisefalse
- Source
- ArrayOps.scala
Selects all elements of this array which satisfy a predicate.
Selects all elements of this array which satisfy a predicate.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
a new array consisting of all elements of this array that satisfy the given predicate
p
. - Source
- ArrayOps.scala
Selects all elements of this array which do not satisfy a predicate.
Selects all elements of this array which do not satisfy a predicate.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
a new array consisting of all elements of this array that do not satisfy the given predicate
p
. - Source
- ArrayOps.scala
Finds the first element of the array satisfying a predicate, if any.
Finds the first element of the array satisfying a predicate, if any.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
an option value containing the first element in the array that satisfies
p
, orNone
if none exists. - Source
- ArrayOps.scala
Builds a new array by applying a function to all elements of this array and using the elements of the resulting collections.
Builds a new array by applying a function to all elements of this array and using the elements of the resulting collections.
Type parameters
- B
-
the element type of the returned array.
Value parameters
- f
-
the function to apply to each element.
Attributes
- Returns
-
a new array resulting from applying the given collection-valued function
f
to each element of this array and concatenating the results. - Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Flattens a two-dimensional array by concatenating all its rows into a single array.
Flattens a two-dimensional array by concatenating all its rows into a single array.
Type parameters
- B
-
Type of row elements.
Value parameters
- asIterable
-
A function that converts elements of this array to rows - Iterables of type
B
.
Attributes
- Returns
-
An array obtained by concatenating rows of this array.
- Source
- ArrayOps.scala
Alias for foldLeft.
Alias for foldLeft.
The type parameter is more restrictive than for foldLeft
to be consistent with IterableOnceOps.fold.
Type parameters
- A1
-
The type parameter for the binary operator, a supertype of
A
.
Value parameters
- op
-
A binary operator.
- z
-
An initial value.
Attributes
- Returns
-
The result of applying
op
toz
and all elements of this array, going left to right. Returnsz
if this string is empty. - Source
- ArrayOps.scala
Applies the given binary operator op
to the given initial value z
and all elements of this array, going left to right.
Applies the given binary operator op
to the given initial value z
and all elements of this array, going left to right. Returns the initial value if this array is empty.
If x1
, x2
, ..., xn
are the elements of this array, the result is op( op( ... op( op(z, x1), x2) ... ), xn)
.
Type parameters
- B
-
The result type of the binary operator.
Value parameters
- op
-
A binary operator.
- z
-
An initial value.
Attributes
- Returns
-
The result of applying
op
toz
and all elements of this array, going left to right. Returnsz
if this array is empty. - Source
- ArrayOps.scala
Applies the given binary operator op
to all elements of this array and the given initial value z
, going right to left.
Applies the given binary operator op
to all elements of this array and the given initial value z
, going right to left. Returns the initial value if this array is empty.
If x1
, x2
, ..., xn
are the elements of this array, the result is op(x1, op(x2, op( ... op(xn, z) ... )))
.
Type parameters
- B
-
The result type of the binary operator.
Value parameters
- op
-
A binary operator.
- z
-
An initial value.
Attributes
- Returns
-
The result of applying
op
to all elements of this array andz
, going right to left. Returnsz
if this array is empty. - Source
- ArrayOps.scala
Tests whether a predicate holds for all elements of this array.
Tests whether a predicate holds for all elements of this array.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
true
if this array is empty or the given predicatep
holds for all elements of this array, otherwisefalse
. - Source
- ArrayOps.scala
Apply f
to each element for its side effects.
Apply f
to each element for its side effects. Note: [U] parameter needed to help scalac's type inference.
Attributes
- Source
- ArrayOps.scala
Partitions this array into a map of arrays according to some discriminator function.
Partitions this array into a map of arrays according to some discriminator function.
Type parameters
- K
-
the type of keys returned by the discriminator function.
Value parameters
- f
-
the discriminator function.
Attributes
- Returns
-
A map from keys to arrays such that the following invariant holds:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
That is, every key
k
is bound to an array of those elementsx
for whichf(x)
equalsk
. - Source
- ArrayOps.scala
Partitions this array into a map of arrays according to a discriminator function key
.
Partitions this array into a map of arrays according to a discriminator function key
. Each element in a group is transformed into a value of type B
using the value
function.
It is equivalent to groupBy(key).mapValues(_.map(f))
, but more efficient.
case class User(name: String, age: Int)
def namesByAge(users: Array[User]): Map[Int, Array[String]] =
users.groupMap(_.age)(_.name)
Type parameters
- B
-
the type of values returned by the transformation function
- K
-
the type of keys returned by the discriminator function
Value parameters
- f
-
the element transformation function
- key
-
the discriminator function
Attributes
- Source
- ArrayOps.scala
Partitions elements in fixed size arrays.
Partitions elements in fixed size arrays.
Value parameters
- size
-
the number of elements per group
Attributes
- Returns
-
An iterator producing arrays of size
size
, except the last will be less than sizesize
if the elements don't divide evenly. - See also
-
scala.collection.Iterator, method
grouped
- Source
- ArrayOps.scala
Selects the first element of this array.
Selects the first element of this array.
Attributes
- Returns
-
the first element of this array.
- Throws
-
NoSuchElementException if the array is empty.
- Source
- ArrayOps.scala
Optionally selects the first element.
Optionally selects the first element.
Attributes
- Returns
-
the first element of this array if it is nonempty,
None
if it is empty. - Source
- ArrayOps.scala
Finds index of first occurrence of some value in this array after or at some start index.
Finds index of first occurrence of some value in this array after or at some start index.
Value parameters
- elem
-
the element value to search for.
- from
-
the start index
Attributes
- Returns
-
the index
>= from
of the first element of this array that is equal (as determined by==
) toelem
, or-1
, if none exists. - Source
- ArrayOps.scala
Finds index of the first element satisfying some predicate after or at some start index.
Finds index of the first element satisfying some predicate after or at some start index.
Value parameters
- from
-
the start index
- p
-
the predicate used to test elements.
Attributes
- Returns
-
the index
>= from
of the first element of this array that satisfies the predicatep
, or-1
, if none exists. - Source
- ArrayOps.scala
Produces the range of all indices of this sequence.
Produces the range of all indices of this sequence.
Attributes
- Returns
-
a
Range
value from0
to one less than the length of this array. - Source
- ArrayOps.scala
The initial part of the array without its last element.
Iterates over the inits of this array.
Iterates over the inits of this array. The first value will be this array and the final one will be an empty array, with the intervening values the results of successive applications of init
.
Attributes
- Returns
-
an iterator over all the inits of this array
- Source
- ArrayOps.scala
Computes the multiset intersection between this array and another sequence.
Computes the multiset intersection between this array and another sequence.
Value parameters
- that
-
the sequence of elements to intersect with.
Attributes
- Returns
-
a new array which contains all elements of this array which also appear in
that
. If an element valuex
appears n times inthat
, then the first n occurrences ofx
will be retained in the result, but any following occurrences will be omitted. - Source
- ArrayOps.scala
Tests whether the array is empty.
Tests whether the array is empty.
Attributes
- Returns
-
true
if the array contains no elements,false
otherwise. - Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
The size of this array.
The size of this array.
Attributes
- Returns
-
the number of elements in this array.
- Source
- ArrayOps.scala
Selects the last element.
Selects the last element.
Attributes
- Returns
-
The last element of this array.
- Throws
-
NoSuchElementException If the array is empty.
- Source
- ArrayOps.scala
Finds index of last occurrence of some value in this array before or at a given end index.
Finds index of last occurrence of some value in this array before or at a given end index.
Value parameters
- elem
-
the element value to search for.
- end
-
the end index.
Attributes
- Returns
-
the index
<= end
of the last element of this array that is equal (as determined by==
) toelem
, or-1
, if none exists. - Source
- ArrayOps.scala
Finds index of last element satisfying some predicate before or at given end index.
Finds index of last element satisfying some predicate before or at given end index.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
the index
<= end
of the last element of this array that satisfies the predicatep
, or-1
, if none exists. - Source
- ArrayOps.scala
Optionally selects the last element.
Optionally selects the last element.
Attributes
- Returns
-
the last element of this array$ if it is nonempty,
None
if it is empty. - Source
- ArrayOps.scala
Analogous to zip
except that the elements in each collection are not consumed until a strict operation is invoked on the returned LazyZip2
decorator.
Analogous to zip
except that the elements in each collection are not consumed until a strict operation is invoked on the returned LazyZip2
decorator.
Calls to lazyZip
can be chained to support higher arities (up to 4) without incurring the expense of constructing and deconstructing intermediary tuples.
val xs = List(1, 2, 3)
val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d)
// res == List(4, 8, 12)
Type parameters
- B
-
the type of the second element in each eventual pair
Value parameters
- that
-
the iterable providing the second element of each eventual pair
Attributes
- Returns
-
a decorator
LazyZip2
that allows strict operations to be performed on the lazily evaluated pairs or chained calls tolazyZip
. Implicit conversion toIterable[(A, B)]
is also supported. - Source
- ArrayOps.scala
Compares the length of this array to a test value.
Compares the length of this array to a test value.
Value parameters
- len
-
the test value that gets compared with the length.
Attributes
- Returns
-
A value
x
wherex < 0 if this.length < len x == 0 if this.length == len x > 0 if this.length > len
- Source
- ArrayOps.scala
Method mirroring SeqOps.lengthIs for consistency, except it returns an Int
because length
is known and comparison is constant-time.
Method mirroring SeqOps.lengthIs for consistency, except it returns an Int
because length
is known and comparison is constant-time.
These operations are equivalent to lengthCompare(Int)
, and allow the following more readable usages:
this.lengthIs < len // this.lengthCompare(len) < 0
this.lengthIs <= len // this.lengthCompare(len) <= 0
this.lengthIs == len // this.lengthCompare(len) == 0
this.lengthIs != len // this.lengthCompare(len) != 0
this.lengthIs >= len // this.lengthCompare(len) >= 0
this.lengthIs > len // this.lengthCompare(len) > 0
Attributes
- Source
- ArrayOps.scala
Builds a new array by applying a function to all elements of this array.
Builds a new array by applying a function to all elements of this array.
Type parameters
- B
-
the element type of the returned array.
Value parameters
- f
-
the function to apply to each element.
Attributes
- Returns
-
a new array resulting from applying the given function
f
to each element of this array and collecting the results. - Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Tests whether the array is not empty.
Tests whether the array is not empty.
Attributes
- Returns
-
true
if the array contains at least one element,false
otherwise. - Source
- ArrayOps.scala
A copy of this array with an element value appended until a given target length is reached.
A copy of this array with an element value appended until a given target length is reached.
Type parameters
- B
-
the element type of the returned array.
Value parameters
- elem
-
the padding value
- len
-
the target length
Attributes
- Returns
-
a new array consisting of all elements of this array followed by the minimal number of occurrences of
elem
so that the resulting collection has a length of at leastlen
. - Source
- ArrayOps.scala
A pair of, first, all elements that satisfy predicate p
and, second, all elements that do not.
A pair of, first, all elements that satisfy predicate p
and, second, all elements that do not.
Attributes
- Source
- ArrayOps.scala
Applies a function f
to each element of the array and returns a pair of arrays: the first one made of those values returned by f
that were wrapped in scala.util.Left, and the second one made of those wrapped in scala.util.Right.
Applies a function f
to each element of the array and returns a pair of arrays: the first one made of those values returned by f
that were wrapped in scala.util.Left, and the second one made of those wrapped in scala.util.Right.
Example:
val xs = Array(1, "one", 2, "two", 3, "three") partitionMap {
case i: Int => Left(i)
case s: String => Right(s)
}
// xs == (Array(1, 2, 3),
// Array(one, two, three))
Type parameters
- A1
-
the element type of the first resulting collection
- A2
-
the element type of the second resulting collection
Value parameters
- f
-
the 'split function' mapping the elements of this array to an scala.util.Either
Attributes
- Returns
-
a pair of arrays: the first one made of those values returned by
f
that were wrapped in scala.util.Left, and the second one made of those wrapped in scala.util.Right. - Source
- ArrayOps.scala
Returns a copy of this array with patched values.
Returns a copy of this array with patched values. Patching at negative indices is the same as patching starting at 0. Patching at indices at or larger than the length of the original array appends the patch to the end. If more values are replaced than actually exist, the excess is ignored.
Value parameters
- from
-
The start index from which to patch
- other
-
The patch values
- replaced
-
The number of values in the original array that are replaced by the patch.
Attributes
- Source
- ArrayOps.scala
Iterates over distinct permutations of elements.
Iterates over distinct permutations of elements.
Attributes
- Returns
-
An Iterator which traverses the distinct permutations of this array.
- Example
-
Array('a', 'b', 'b').permutations.map(runtime.ScalaRunTime.stringOf).foreach(println) // Array(a, b, b) // Array(b, a, b) // Array(b, b, a)
- Source
- ArrayOps.scala
A copy of this array with an element prepended.
A copy of this array with all elements of a collection prepended.
A copy of this array with all elements of an array prepended.
Returns a new array with the elements in reversed order.
An iterator yielding elements in reversed order.
An iterator yielding elements in reversed order.
Note: xs.reverseIterator
is the same as xs.reverse.iterator
but implemented more efficiently.
Attributes
- Returns
-
an iterator yielding the elements of this array in reversed order
- Source
- ArrayOps.scala
Computes a prefix scan of the elements of the array.
Computes a prefix scan of the elements of the array.
Note: The neutral element z
may be applied more than once.
Type parameters
- B
-
element type of the resulting array
Value parameters
- op
-
the associative operator for the scan
- z
-
neutral element for the operator
op
Attributes
- Returns
-
a new array containing the prefix scan of the elements in this array
- Source
- ArrayOps.scala
Produces an array containing cumulative results of applying the binary operator going left to right.
Produces an array containing cumulative results of applying the binary operator going left to right.
Type parameters
- B
-
the result type of the binary operator.
Value parameters
- op
-
the binary operator.
- z
-
the start value.
Attributes
- Returns
-
array with intermediate values. Example:
Array(1, 2, 3, 4).scanLeft(0)(_ + _) == Array(0, 1, 3, 6, 10)
- Source
- ArrayOps.scala
Produces an array containing cumulative results of applying the binary operator going right to left.
Produces an array containing cumulative results of applying the binary operator going right to left.
Type parameters
- B
-
the result type of the binary operator.
Value parameters
- op
-
the binary operator.
- z
-
the start value.
Attributes
- Returns
-
array with intermediate values. Example:
Array(4, 3, 2, 1).scanRight(0)(_ + _) == Array(10, 6, 3, 1, 0)
- Source
- ArrayOps.scala
The size of this array.
The size of this array.
Attributes
- Returns
-
the number of elements in this array.
- Source
- ArrayOps.scala
Compares the size of this array to a test value.
Compares the size of this array to a test value.
Value parameters
- otherSize
-
the test value that gets compared with the size.
Attributes
- Returns
-
A value
x
wherex < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
- Source
- ArrayOps.scala
Method mirroring SeqOps.sizeIs for consistency, except it returns an Int
because size
is known and comparison is constant-time.
Method mirroring SeqOps.sizeIs for consistency, except it returns an Int
because size
is known and comparison is constant-time.
These operations are equivalent to sizeCompare(Int)
, and allow the following more readable usages:
this.sizeIs < size // this.sizeCompare(size) < 0
this.sizeIs <= size // this.sizeCompare(size) <= 0
this.sizeIs == size // this.sizeCompare(size) == 0
this.sizeIs != size // this.sizeCompare(size) != 0
this.sizeIs >= size // this.sizeCompare(size) >= 0
this.sizeIs > size // this.sizeCompare(size) > 0
Attributes
- Source
- ArrayOps.scala
Selects an interval of elements.
Selects an interval of elements. The returned array is made up of all elements x
which satisfy the invariant:
from <= indexOf(x) < until
Value parameters
- from
-
the lowest index to include from this array.
- until
-
the lowest index to EXCLUDE from this array.
Attributes
- Returns
-
an array containing the elements greater than or equal to index
from
extending up to (but not including) indexuntil
of this array. - Source
- ArrayOps.scala
Groups elements in fixed size blocks by passing a "sliding window" over them (as opposed to partitioning them, as is done in grouped.)
Groups elements in fixed size blocks by passing a "sliding window" over them (as opposed to partitioning them, as is done in grouped.)
Value parameters
- size
-
the number of elements per group
- step
-
the distance between the first elements of successive groups
Attributes
- Returns
-
An iterator producing arrays of size
size
, except the last element (which may be the only element) will be truncated if there are fewer thansize
elements remaining to be grouped. - See also
-
scala.collection.Iterator, method
sliding
- Source
- ArrayOps.scala
Sorts this array according to the Ordering which results from transforming an implicitly given Ordering with a transformation function.
Sorts this array according to the Ordering which results from transforming an implicitly given Ordering with a transformation function.
Type parameters
- B
-
the target type of the transformation
f
, and the type where the orderingord
is defined.
Value parameters
- f
-
the transformation function mapping elements to some other domain
B
. - ord
-
the ordering assumed on domain
B
.
Attributes
- Returns
-
an array consisting of the elements of this array sorted according to the ordering where
x < y
iford.lt(f(x), f(y))
. - See also
- Source
- ArrayOps.scala
Sorts this array according to a comparison function.
Sorts this array according to a comparison function.
The sort is stable. That is, elements that are equal (as determined by lt
) appear in the same order in the sorted sequence as in the original.
Value parameters
- lt
-
the comparison function which tests whether its first argument precedes its second argument in the desired ordering.
Attributes
- Returns
-
an array consisting of the elements of this array sorted according to the comparison function
lt
. - Source
- ArrayOps.scala
Sorts this array according to an Ordering.
Sorts this array according to an Ordering.
The sort is stable. That is, elements that are equal (as determined by lt
) appear in the same order in the sorted sequence as in the original.
Value parameters
- ord
-
the ordering to be used to compare elements.
Attributes
- Returns
-
an array consisting of the elements of this array sorted according to the ordering
ord
. - See also
- Source
- ArrayOps.scala
Splits this array into a prefix/suffix pair according to a predicate.
Splits this array into a prefix/suffix pair according to a predicate.
Note: c span p
is equivalent to (but more efficient than) (c takeWhile p, c dropWhile p)
, provided the evaluation of the predicate p
does not cause any side-effects.
Value parameters
- p
-
the test predicate
Attributes
- Returns
-
a pair consisting of the longest prefix of this array whose elements all satisfy
p
, and the rest of this array. - Source
- ArrayOps.scala
Splits this array into two at a given position.
Splits this array into two at a given position. Note: c splitAt n
is equivalent to (c take n, c drop n)
.
Value parameters
- n
-
the position at which to split.
Attributes
- Returns
-
a pair of arrays consisting of the first
n
elements of this array, and the other elements. - Source
- ArrayOps.scala
Tests whether this array starts with the given array.
Tests whether this array contains the given array at a given index.
Tests whether this array contains the given array at a given index.
Value parameters
- offset
-
the index where the array is searched.
- that
-
the array to test
Attributes
- Returns
-
true
if the arraythat
is contained in this array at indexoffset
, otherwisefalse
. - Source
- ArrayOps.scala
Tests whether this array contains the given sequence at a given index.
Tests whether this array contains the given sequence at a given index.
Value parameters
- offset
-
the index where the sequence is searched.
- that
-
the sequence to test
Attributes
- Returns
-
true
if the sequencethat
is contained in this array at indexoffset
, otherwisefalse
. - Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
The rest of the array without its first element.
Iterates over the tails of this array.
Iterates over the tails of this array. The first value will be this array and the final one will be an empty array, with the intervening values the results of successive applications of tail
.
Attributes
- Returns
-
an iterator over all the tails of this array
- Source
- ArrayOps.scala
An array containing the first n
elements of this array.
An array containing the last n
elements of this array.
Takes longest prefix of elements that satisfy a predicate.
Takes longest prefix of elements that satisfy a predicate.
Value parameters
- p
-
The predicate used to test elements.
Attributes
- Returns
-
the longest prefix of this array whose elements all satisfy the predicate
p
. - Source
- ArrayOps.scala
Create a copy of this array with the specified element type.
Attributes
- Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Transposes a two dimensional array.
Transposes a two dimensional array.
Type parameters
- B
-
Type of row elements.
Value parameters
- asArray
-
A function that converts elements of this array to rows - arrays of type
B
.
Attributes
- Returns
-
An array obtained by replacing elements of this arrays with rows the represent.
- Source
- ArrayOps.scala
Converts an array of pairs into an array of first elements and an array of second elements.
Converts an array of pairs into an array of first elements and an array of second elements.
Type parameters
- A1
-
the type of the first half of the element pairs
- A2
-
the type of the second half of the element pairs
Value parameters
- asPair
-
an implicit conversion which asserts that the element type of this Array is a pair.
- ct1
-
a class tag for
A1
type parameter that is required to create an instance ofArray[A1]
- ct2
-
a class tag for
A2
type parameter that is required to create an instance ofArray[A2]
Attributes
- Returns
-
a pair of Arrays, containing, respectively, the first and second half of each element pair of this Array.
- Source
- ArrayOps.scala
Converts an array of triples into three arrays, one containing the elements from each position of the triple.
Converts an array of triples into three arrays, one containing the elements from each position of the triple.
Type parameters
- A1
-
the type of the first of three elements in the triple
- A2
-
the type of the second of three elements in the triple
- A3
-
the type of the third of three elements in the triple
Value parameters
- asTriple
-
an implicit conversion which asserts that the element type of this Array is a triple.
- ct1
-
a class tag for T1 type parameter that is required to create an instance of Array[T1]
- ct2
-
a class tag for T2 type parameter that is required to create an instance of Array[T2]
- ct3
-
a class tag for T3 type parameter that is required to create an instance of Array[T3]
Attributes
- Returns
-
a triple of Arrays, containing, respectively, the first, second, and third elements from each element triple of this Array.
- Source
- ArrayOps.scala
A copy of this array with one single replaced element.
A copy of this array with one single replaced element.
Value parameters
- elem
-
the replacing element
- index
-
the position of the replacement
Attributes
- Returns
-
a new array which is a copy of this array with the element at position
index
replaced byelem
. - Throws
-
IndexOutOfBoundsException if
index
does not satisfy0 <= index < length
. - Source
- ArrayOps.scala
Attributes
- Source
- ArrayOps.scala
Creates a non-strict filter of this array.
Creates a non-strict filter of this array.
Note: the difference between c filter p
and c withFilter p
is that the former creates a new array, whereas the latter only restricts the domain of subsequent map
, flatMap
, foreach
, and withFilter
operations.
Value parameters
- p
-
the predicate used to test elements.
Attributes
- Returns
-
an object of class
ArrayOps.WithFilter
, which supportsmap
,flatMap
,foreach
, andwithFilter
operations. All these operations apply to those elements of this array which satisfy the predicatep
. - Source
- ArrayOps.scala
Returns an array formed from this array and another iterable collection by combining corresponding elements in pairs.
Returns an array formed from this array and another iterable collection by combining corresponding elements in pairs. If one of the two collections is longer than the other, its remaining elements are ignored.
Type parameters
- B
-
the type of the second half of the returned pairs
Value parameters
- that
-
The iterable providing the second half of each result pair
Attributes
- Returns
-
a new array containing pairs consisting of corresponding elements of this array and
that
. The length of the returned array is the minimum of the lengths of this array andthat
. - Source
- ArrayOps.scala
Returns an array formed from this array and another iterable collection by combining corresponding elements in pairs.
Returns an array formed from this array and another iterable collection by combining corresponding elements in pairs. If one of the two collections is shorter than the other, placeholder elements are used to extend the shorter collection to the length of the longer.
Value parameters
- that
-
the iterable providing the second half of each result pair
- thatElem
-
the element to be used to fill up the result if
that
is shorter than this array. - thisElem
-
the element to be used to fill up the result if this array is shorter than
that
.
Attributes
- Returns
-
a new array containing pairs consisting of corresponding elements of this array and
that
. The length of the returned array is the maximum of the lengths of this array andthat
. If this array is shorter thanthat
,thisElem
values are used to pad the result. Ifthat
is shorter than this array,thatElem
values are used to pad the result. - Source
- ArrayOps.scala
Zips this array with its indices.
Zips this array with its indices.
Attributes
- Returns
-
A new array containing pairs consisting of all elements of this array paired with their index. Indices start at
0
. - Source
- ArrayOps.scala