We need a whole WithFilter class to honor the "doesn't create a new collection" contract even though it seems unlikely to matter much in a collection with max size 1.
We need a whole WithFilter class to honor the "doesn't create a new collection" contract even though it seems unlikely to matter much in a collection with max size 1.
Test two objects for inequality.
Test two objects for inequality.
true
if !(this == that), false otherwise.
Equivalent to x.hashCode
except for boxed numeric types and null
.
Equivalent to x.hashCode
except for boxed numeric types and null
.
For numerics, it returns a hash value which is consistent
with value equality: if two value type instances compare
as true, then ## will produce the same hash value for each
of them.
For null
returns a hashcode where null.hashCode
throws a
NullPointerException
.
a hash value consistent with ==
The expression x == that
is equivalent to if (x eq null) that eq null else x.equals(that)
.
The expression x == that
is equivalent to if (x eq null) that eq null else x.equals(that)
.
the object to compare against this object for equality.
true
if the receiver object is equivalent to the argument; false
otherwise.
Cast the receiver object to be of type T0
.
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 expression 1.asInstanceOf[String]
will throw a ClassCastException
at
runtime, while the expression List(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 type.
the receiver object.
ClassCastException
if the receiver object is not an instance of the erasure of type T0
.
Create a copy of the receiver object.
Returns a scala.Some containing the result of
applying pf
to this scala.Option's contained
value, if this option is
nonempty and pf
is defined for that value.
Returns a scala.Some containing the result of
applying pf
to this scala.Option's contained
value, if this option is
nonempty and pf
is defined for that value.
Returns None
otherwise.
the partial function.
the result of applying pf
to this scala.Option's
value (if possible), or None
.
// Returns Some(HTTP) because the partial function covers the case. Some("http") collect {case "http" => "HTTP"} // Returns None because the partial function doesn't cover the case. Some("ftp") collect {case "http" => "HTTP"} // Returns None because None is passed to the collect method. None collect {case value => value}
Tests whether the option contains a given value as an element.
Tests whether the option contains a given value as an element.
the element to test.
true
if the option has an element that is equal (as
determined by ==
) to elem
, false
otherwise.
// Returns true because Some instance contains string "something" which equals "something". Some("something") contains "something" // Returns false because "something" != "anything". Some("something") contains "anything" // Returns false when method called on None. None contains "anything"
Tests whether the argument (arg0
) is a reference to the receiver object (this
).
Tests whether the argument (arg0
) is a reference to the receiver object (this
).
The eq
method implements an equivalence relation on
non-null instances of AnyRef
, and has three additional properties:
x
and y
of type AnyRef
, multiple invocations of
x.eq(y)
consistently returns true
or consistently returns false
.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
).
true
if the argument is a reference to the receiver object; false
otherwise.
The equality method for reference types.
Returns true if this option is nonempty and the predicate
p
returns true when applied to this scala.Option's value.
Returns true if this option is nonempty and the predicate
p
returns true when applied to this scala.Option's value.
Otherwise, returns false.
the predicate to test
Returns this scala.Option if it is nonempty and applying the predicate p
to
this scala.Option's value returns true.
Returns this scala.Option if it is nonempty and applying the predicate p
to
this scala.Option's value returns true. Otherwise, return None
.
the predicate used for testing.
Returns this scala.Option if it is nonempty and applying the predicate p
to
this scala.Option's value returns false.
Returns this scala.Option if it is nonempty and applying the predicate p
to
this scala.Option's value returns false. Otherwise, return None
.
the predicate used for testing.
Called by the garbage collector on the receiver object when there are no more references to the object.
Called by the garbage collector on the receiver object when there are no more references to the object.
The details of when and if the finalize
method is invoked, as
well as the interaction between finalize
and non-local returns
and exceptions, are all platform dependent.
Returns the result of applying f
to this scala.Option's value if
this scala.Option is nonempty.
Returns the result of applying f
to this scala.Option's value if
this scala.Option is nonempty.
Returns None
if this scala.Option is empty.
Slightly different from map
in that f
is expected to
return an scala.Option (which could be None
).
the function to apply
Returns the result of applying f
to this scala.Option's
value if the scala.Option is nonempty.
Returns the result of applying f
to this scala.Option's
value if the scala.Option is nonempty. Otherwise, evaluates
expression ifEmpty
.
the expression to evaluate if empty.
the function to apply if nonempty.
This is equivalent to scala.Option map f getOrElse ifEmpty
.
Returns true if this option is empty or the predicate
p
returns true when applied to this scala.Option's value.
Returns true if this option is empty or the predicate
p
returns true when applied to this scala.Option's value.
the predicate to test
Apply the given procedure f
to the option's value,
if it is nonempty.
Returns the option's value.
A representation that corresponds to the dynamic class of the receiver object.
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.
not specified by SLS as a member of AnyRef
Returns the option's value if the option is nonempty, otherwise
return the result of evaluating default
.
Returns true if the option is an instance of scala.Some, false otherwise.
Returns true if the option is an instance of scala.Some, false otherwise.
Returns true if the option is None
, false otherwise.
Test whether the dynamic type of the receiver object is T0
.
Test whether the dynamic type of the receiver object is T0
.
Note that the result of the test is modulo Scala's erasure semantics.
Therefore the expression 1.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 specified type.
true
if the receiver object is an instance of erasure of type T0
; false
otherwise.
Returns a singleton iterator returning the scala.Option's value if it is nonempty, or an empty iterator if the option is empty.
Returns a singleton iterator returning the scala.Option's value if it is nonempty, or an empty iterator if the option is empty.
Returns a scala.Some containing the result of applying f
to this scala.Option's
value if this scala.Option is nonempty.
Returns a scala.Some containing the result of applying f
to this scala.Option's
value if this scala.Option is nonempty.
Otherwise return None
.
the function to apply
This is similar to flatMap
except here,
f
does not need to wrap its result in an scala.Option.
foreach
flatMap
Equivalent to !(this eq that)
.
Equivalent to !(this eq that)
.
true
if the argument is not a reference to the receiver object; false
otherwise.
Returns false if the option is None
, true otherwise.
Returns false if the option is None
, true otherwise.
Implemented here to avoid the implicit conversion to Iterable.
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.
not specified by SLS as a member of AnyRef
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.
not specified by SLS as a member of AnyRef
Returns this scala.Option if it is nonempty,
otherwise return the result of evaluating alternative
.
Returns this scala.Option if it is nonempty,
otherwise return the result of evaluating alternative
.
the alternative expression.
Returns the option's value if it is nonempty,
or null
if it is empty.
Returns the option's value if it is nonempty,
or null
if it is empty.
Although the use of null is discouraged, code written to use
scala.Option must often interface with code that expects and returns nulls.
Returns a scala.util.Right containing the given
argument right
if this is empty, or
a scala.util.Left containing this scala.Option's value
if this scala.Option is nonempty.
Returns a scala.util.Right containing the given
argument right
if this is empty, or
a scala.util.Left containing this scala.Option's value
if this scala.Option is nonempty.
the expression to evaluate and return if this is empty
Returns a singleton list containing the scala.Option's value if it is nonempty, or the empty list if the scala.Option is empty.
Returns a singleton list containing the scala.Option's value if it is nonempty, or the empty list if the scala.Option is empty.
Returns a scala.util.Left containing the given
argument left
if this scala.Option is empty, or
a scala.util.Right containing this scala.Option's value if
this is nonempty.
Returns a scala.util.Left containing the given
argument left
if this scala.Option is empty, or
a scala.util.Right containing this scala.Option's value if
this is nonempty.
the expression to evaluate and return if this is empty
Necessary to keep scala.Option from being implicitly converted to
scala.collection.Iterable in for
comprehensions.
Necessary to keep scala.Option from being implicitly converted to
scala.collection.Iterable in for
comprehensions.
This case object represents non-existent values.
1.0, 16/07/2003