The underlying collection type with unknown element type
The underlying collection type with unknown element type
A generic implementation of the CanBuildFrom
trait, which forwards
all calls to apply(from)
to the genericBuilder
method of
collection from
, and which forwards all calls of apply()
to the
newBuilder
method of this factory.
o != arg0
is the same as !(o == (arg0))
.
o != arg0
is the same as !(o == (arg0))
.
the object to compare against this object for dis-equality.
false
if the receiver object is equivalent to the argument; true
otherwise.
o == arg0
is the same as if (o eq null) arg0 eq null else o.equals(arg0)
.
o == arg0
is the same as if (o eq null) arg0 eq null else o.equals(arg0)
.
the object to compare against this object for equality.
true
if the receiver object is equivalent to the argument; false
otherwise.
o == arg0
is the same as o.equals(arg0)
.
o == arg0
is the same as o.equals(arg0)
.
the object to compare against this object for equality.
true
if the receiver object is equivalent to the argument; false
otherwise.
Creates a list with the specified elements.
Creates a list with the specified elements.
the type of the list's elements
a new list with elements elems
This method is used to cast the receiver object to be of type T0
.
This method is used to cast the receiver object to be of type T0
.
Note that the success of a cast at runtime is modulo Scala's erasure semantics. Therefore the expression1.asInstanceOf[String]
will throw a ClassCastException
at runtime, while the expressionList(1).asInstanceOf[List[String]]
will not. In the latter example, because the type argument is erased as
part of compilation it is not possible to check whether the contents of the list are of the requested typed.
the receiver object.
The standard CanBuildFrom
instance for List objects.
The standard CanBuildFrom
instance for List objects.
The created value is an instance of class GenericCanBuildFrom
,
which forwards calls to create a new builder to the
genericBuilder
method of the requesting collection.
GenericCanBuildFrom
CanBuildFrom
This method creates and returns a copy of the receiver object.
This method creates and returns a copy of the receiver object.
The default implementation of the clone
method is platform dependent.
a copy of the receiver object.
Concatenates all argument collections into a single list.
Concatenates all argument collections into a single list.
the collections that are to be concatenated.
the concatenation of all the collections.
An empty collection of type List[A]
An empty collection of type List[A]
the type of the list's elements
This method is used to test whether the argument (arg0
) is a reference to the
receiver object (this
).
This method is used to test whether the argument (arg0
) is a reference to the
receiver object (this
).
The eq
method implements an [http://en.wikipedia.org/wiki/Equivalence_relation equivalence relation] on
non-null instances of AnyRef
:
* It is reflexive: for any non-null instance x
of type AnyRef
, x.eq(x)
returns true
.
* It is symmetric: for any non-null instances x
and y
of type AnyRef
, x.eq(y)
returns true
if and
only if y.eq(x)
returns true
.
* It is transitive: for any non-null instances x
, y
, and z
of type AnyRef
if x.eq(y)
returns true
and y.eq(z)
returns true
, then x.eq(z)
returns true
.
Additionally, the eq
method has three other properties.
* It is consistent: for any non-null instances x
and y
of type AnyRef
, multiple invocations of
x.eq(y)
consistently returns true
or consistently returns false
.
* For any non-null instance x
of type AnyRef
, x.eq(null)
and null.eq(x)
returns false
.
* null.eq(null)
returns true
.
When overriding the equals
or hashCode
methods, it is important to ensure that their behavior is
consistent with reference equality. Therefore, if two objects are references to each other (o1 eq o2
), they
should be equal to each other (o1 == o2
) and they should hash to the same value (o1.hashCode == o2.hashCode
).
the object to compare against this object for reference equality.
true
if the argument is a reference to the receiver object; false
otherwise.
This method is used to compare the receiver object (this
) with the argument object (arg0
) for equivalence.
This method is used to compare the receiver object (this
) with the argument object (arg0
) for equivalence.
The default implementations of this method is an [http://en.wikipedia.org/wiki/Equivalence_relation equivalence
relation]:
* It is reflexive: for any instance x
of type Any
, x.equals(x)
should return true
.
* It is symmetric: for any instances x
and y
of type Any
, x.equals(y)
should return true
if and
only if y.equals(x)
returns true
.
* It is transitive: for any instances x
, y
, and z
of type AnyRef
if x.equals(y)
returns true
and
y.equals(z)
returns true
, then x.equals(z)
should return true
.
If you override this method, you should verify that your implementation remains an equivalence relation.
Additionally, when overriding this method it is often necessary to override hashCode
to ensure that objects
that are "equal" (o1.equals(o2)
returns true
) hash to the same
scala.Int
(o1.hashCode.equals(o2.hashCode)
).
the object to compare against this object for equality.
true
if the receiver object is equivalent to the argument; false
otherwise.
Tests whether the given predicate p
holds
for some corresponding elements of the argument lists.
Tests whether the given predicate p
holds
for some corresponding elements of the argument lists.
n != 0 && (p(a<sub>0</sub>,b<sub>0</sub>) ||
... || p(a<sub>n</sub>,b<sub>n</sub>))]
if the lists are
[a<sub>0</sub>, ..., a<sub>k</sub>]
,
[b<sub>0</sub>, ..., b<sub>l</sub>]
and
n = min(k,l)
use (xs, ys).zipped.exists(f)' instead of
List.exists2(xs, ys)(f)'
Produces a five-dimensional list containing the results of some element computation a number of times.
Produces a five-dimensional list containing the results of some element computation a number of times.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
the number of elements in the 4th dimension
the number of elements in the 5th dimension
the element computation
A list that contains the results of n1 x n2 x n3 x n4 x n5
evaluations of elem
.
Produces a four-dimensional list containing the results of some element computation a number of times.
Produces a four-dimensional list containing the results of some element computation a number of times.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
the number of elements in the 4th dimension
the element computation
A list that contains the results of n1 x n2 x n3 x n4
evaluations of elem
.
Produces a three-dimensional list containing the results of some element computation a number of times.
Produces a three-dimensional list containing the results of some element computation a number of times.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
the element computation
A list that contains the results of n1 x n2 x n3
evaluations of elem
.
Produces a two-dimensional list containing the results of some element computation a number of times.
Produces a two-dimensional list containing the results of some element computation a number of times.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the element computation
A list that contains the results of n1 x n2
evaluations of elem
.
Produces a list containing the results of some element computation a number of times.
Produces a list containing the results of some element computation a number of times.
the number of elements contained in the list.
the element computation
A list that contains the results of n
evaluations of elem
.
This method is called by the garbage collector on the receiver object when garbage collection determines that there are no more references to the object.
This method is called by the garbage collector on the receiver object when garbage collection determines that there are no more references to the object.
The details of when and if the finalize
method are invoked, as well as the interaction between finalize
and non-local returns and exceptions, are all platform dependent.
Concatenate all the elements of a given list of lists.
Concatenate all the elements of a given list of lists.
the list of lists that are to be concatenated
the concatenation of all the lists
use xss.flatten' instead of
List.flatten(xss)'
Tests whether the given predicate p
holds
for all corresponding elements of the argument lists.
Tests whether the given predicate p
holds
for all corresponding elements of the argument lists.
(p(a<sub>0</sub>,b<sub>0</sub>) &&
... && p(a<sub>n</sub>,b<sub>n</sub>))]
if the lists are [a<sub>0</sub>, ..., a<sub>k</sub>]
;
[b<sub>0</sub>, ..., b<sub>l</sub>]
and n = min(k,l)
use (xs, ys).zipped.forall(f)' instead of
List.forall2(xs, ys)(f)'
Converts a range of an array into a list.
Converts a range of an array into a list.
the array to convert
the first index to consider
the length of the range to convert
a list that contains the same elements than arr
in the same order
use array.view(start, end).toList' instead of
List.fromArray(array, start, end)'
Converts an array into a list.
Converts an array into a list.
the array to convert
a list that contains the same elements than arr
in the same order
use array.toList' instead of
List.fromArray(array)'
Converts an iterator to a list.
Converts an iterator to a list.
the iterator to convert
a list that contains the elements returned by successive
calls to it.next
use it.toList' instead of
List.toList(it)'
Parses a string which contains substrings separated by a separator character and returns a list of all substrings.
Parses a string which contains substrings separated by a separator character and returns a list of all substrings.
the string to parse
the separator character
the list of substrings
use str.split(separator).toList' instead of
List.fromString(str, separator)'
Returns a representation that corresponds to the dynamic class of the receiver object.
Returns a representation that corresponds to the dynamic class of the receiver object.
The nature of the representation is platform dependent.
a representation that corresponds to the dynamic class of the receiver object.
Returns a hash code value for the object.
Returns a hash code value for the object.
The default hashing algorithm is platform dependent.
Note that it is allowed for two objects to have identical hash codes (o1.hashCode.equals(o2.hashCode)
) yet
not be equal (o1.equals(o2)
returns false
). A degenerate implementation could always return 0
.
However, it is required that if two objects are equal (o1.equals(o2)
returns true
) that they have
identical hash codes (o1.hashCode.equals(o2.hashCode)
). Therefore, when overriding this method, be sure
to verify that the behavior is consistent with the equals
method.
the hash code value for the object.
This method is used to test whether the dynamic type of the receiver object is T0
.
This method is used to test whether the dynamic type of the receiver object is T0
.
Note that the test result of the test is modulo Scala's erasure semantics. Therefore the expression1.isInstanceOf[String]
will return false
, while the expression List(1).isInstanceOf[List[String]]
will
return true
. In the latter example, because the type argument is erased as part of compilation it is not
possible to check whether the contents of the list are of the requested typed.
true
if the receiver object is an instance of erasure of type T0
; false
otherwise.
Produces a list containing repeated applications of a function to a start value.
Produces a list containing repeated applications of a function to a start value.
the start value of the list
the number of elements contained inthe list
the function that's repeatedly applied
a list with len
values in the sequence start, f(start), f(f(start)), ...
Returns the Left
values in the given Iterable
of Either
s.
Returns the Left
values in the given Iterable
of Either
s.
use xs collect { case Left(x: A) => x }' instead of
List.lefts(xs)'
Create a list containing several copies of an element.
Create a list containing several copies of an element.
the length of the resulting list
the element composing the resulting list
a list composed of n elements all equal to elem
use fill' instead
Returns the list resulting from applying the given function f
to corresponding elements of the argument lists.
Returns the list resulting from applying the given function f
to corresponding elements of the argument lists.
function to apply to each pair of elements.
[f(a0,b0), ..., f(an,bn)]
if the lists are
[a0, ..., ak]
, [b0, ..., bl]
and
n = min(k,l)
use (xs, ys).zipped.map(f)' instead of
List.map2(xs, ys)(f)'
Returns the list resulting from applying the given function
f
to corresponding elements of the argument lists.
Returns the list resulting from applying the given function
f
to corresponding elements of the argument lists.
function to apply to each pair of elements.
[f(a<sub>0</sub>,b<sub>0</sub>,c<sub>0</sub>),
..., f(a<sub>n</sub>,b<sub>n</sub>,c<sub>n</sub>)]
if the lists are [a<sub>0</sub>, ..., a<sub>k</sub>]
,
[b<sub>0</sub>, ..., b<sub>l</sub>]
,
[c<sub>0</sub>, ..., c<sub>m</sub>]
and
n = min(k,l,m)
use (xs, ys, zs).zipped.map(f)' instead of
List.map3(xs, ys, zs)(f)'
Like xs map f, but returns xs
unchanged if function
f
maps all elements to themselves.
Like xs map f, but returns xs
unchanged if function
f
maps all elements to themselves.
use xs.mapConserve(f)' instead of
List.mapConserve(xs, f)'
o.ne(arg0)
is the same as !(o.eq(arg0))
.
o.ne(arg0)
is the same as !(o.eq(arg0))
.
the object to compare against this object for reference dis-equality.
false
if the argument is not a reference to the receiver object; true
otherwise.
The default builder for List
objects.
The default builder for List
objects.
the type of the list's elements
Wakes up a single thread that is waiting on the receiver object's monitor.
Wakes up a single thread that is waiting on the receiver object's monitor.
Wakes up all threads that are waiting on the receiver object's monitor.
Wakes up all threads that are waiting on the receiver object's monitor.
Create a sorted list with element valuesv<sub>n+1</sub> = step(v<sub>n</sub>)
where v<sub>0</sub> = start
and elements are in the range between start
(inclusive)
and end
(exclusive)
Create a sorted list with element valuesv<sub>n+1</sub> = step(v<sub>n</sub>)
where v<sub>0</sub> = start
and elements are in the range between start
(inclusive)
and end
(exclusive)
the start value of the list
the end value of the list
the increment function of the list, which given v<sub>n</sub>
,
computes v<sub>n+1</sub>
. Must be monotonically increasing
or decreasing.
the sorted list of all integers in range [start;end).
use iterate' instead
Produces a list containing equally spaced values in some integer interval.
Produces a list containing equally spaced values in some integer interval.
the start value of the list
the end value of the list (the first value NOT contained)
the difference between successive elements of the list (must be positive or negative)
a list with values start, start + step, ...
up to, but excluding end
Produces a list containing a sequence of increasing of integers.
Produces a list containing a sequence of increasing of integers.
the end value of the list (the first value NOT contained)
a list with values start, start + 1, ..., end - 1
Returns the Right
values in the givenIterable
of Either
s.
Returns the Right
values in the givenIterable
of Either
s.
use xs collect { case Right(x: B) => x }' instead of
List.rights(xs)'
Transforms an Iterable of Eithers into a pair of lists.
Transforms an Iterable of Eithers into a pair of lists.
a pair of lists.
use (for (Left(x) <- es) yield x, for (Right(x) <- es) yield x)
instead
Produces a five-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a five-dimensional list containing values of a given function over ranges of integer values starting from 0.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
the number of elements in the 4th dimension
the number of elements in the 5th dimension
The function computing element values
A list consisting of elements f(i1, i2, i3, i4, i5)
for 0 <= i1 < n1
, 0 <= i2 < n2
, 0 <= i3 < n3
, 0 <= i4 < n4
, and 0 <= i5 < n5
.
Produces a four-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a four-dimensional list containing values of a given function over ranges of integer values starting from 0.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
the number of elements in the 4th dimension
The function computing element values
A list consisting of elements f(i1, i2, i3, i4)
for 0 <= i1 < n1
, 0 <= i2 < n2
, 0 <= i3 < n3
, and 0 <= i4 < n4
.
Produces a three-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a three-dimensional list containing values of a given function over ranges of integer values starting from 0.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
the number of elements in the 3nd dimension
The function computing element values
A list consisting of elements f(i1, i2, i3)
for 0 <= i1 < n1
, 0 <= i2 < n2
, and 0 <= i3 < n3
.
Produces a two-dimensional list containing values of a given function over ranges of integer values starting from 0.
Produces a two-dimensional list containing values of a given function over ranges of integer values starting from 0.
the number of elements in the 1st dimension
the number of elements in the 2nd dimension
The function computing element values
A list consisting of elements f(i1, i2)
for 0 <= i1 < n1
and 0 <= i2 < n2
.
Produces a list containing values of a given function over a range of integer values starting from 0.
Produces a list containing values of a given function over a range of integer values starting from 0.
The number of elements in the list
The function computing element values
A list consisting of elements f(0), ..., f(n -1)
Returns the given list of characters as a string.
Returns the given list of characters as a string.
the list to convert.
the list in form of a string.
use xs.mkString' instead of
List.toString(xs)'
Returns a string representation of the object.
Returns a string representation of the object.
The default representation is platform dependent.
a string representation of the object.
Transposes a list of lists.
Transposes a list of lists. pre: All element lists have the same length.
the list of lists
the transposed list of lists
use xss.transpose' instead of
List.transpose(xss)'
This method is called in a pattern match { case Seq(.
This method is called in a pattern match { case Seq(...) => }.
the selector value
sequence wrapped in an option, if this is a Seq, otherwise none
Transforms an iterable of pairs into a pair of lists.
Transforms an iterable of pairs into a pair of lists.
the iterable of pairs to unzip
a pair of lists.
use xs.unzip' instead of
List.unzip(xs)'
Transforms a list of pairs into a pair of lists.
Transforms a list of pairs into a pair of lists.
the list of pairs to unzip
a pair of lists.
use xs.unzip' instead of
List.unzip(xs)'
This object provides a set of operations to create
List
values.version
2.8