|
|
|
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |
Class OptionalLong
java.util.OptionalLong
public final class OptionalLong
A container object which may or may not contain a
long value.
If a value is present,
isPresent() returns
true. If no
value is present, the object is considered
empty and
isPresent() returns
false.
Additional methods that depend on the presence or absence of a contained
value are provided, such as orElse()
(returns a default value if no value is present) and
ifPresent() (performs an
action if a value is present).
This is a value-based
class; programmers should treat instances that are
equal as interchangeable and should not
use instances for synchronization, or unpredictable behavior may
occur. For example, in a future release, synchronization may fail.
Since:
1.8
Method Summary |
|
Returns an empty OptionalLong instance.
|
boolean |
Indicates whether some other object is "equal to" this
OptionalLong.
|
long |
If a value is present, returns the value, otherwise throws
NoSuchElementException.
|
int |
Returns the hash code of the value, if present, otherwise 0
(zero) if no value is present.
|
void |
If a value is present, performs the given action with the value,
otherwise does nothing.
|
void |
If a value is present, performs the given action with the value,
otherwise performs the given empty-based action.
|
boolean |
If a value is not present, returns true, otherwise
false.
|
boolean |
If a value is present, returns true, otherwise false.
|
|
Returns an OptionalLong describing the given value.
|
long |
If a value is present, returns the value, otherwise returns
other.
|
long |
If a value is present, returns the value, otherwise returns the result
produced by the supplying function.
|
long |
If a value is present, returns the value, otherwise throws
NoSuchElementException.
|
|
If a value is present, returns the value, otherwise throws an exception
produced by the exception supplying function.
|
|
If a value is present, returns a sequential LongStream containing
only that value, otherwise returns an empty LongStream.
|
|
Returns a non-empty string representation of this OptionalLong
suitable for debugging.
|
Methods inherited from class java.lang. Object |
|
Returns an empty
OptionalLong instance. No value is present for
this
OptionalLong.
Returns:
an empty OptionalLong.
Returns an
OptionalLong describing the given value.
Parameters:
value - the value to describe
Returns:
an OptionalLong with the value present
If a value is present, returns the value, otherwise throws
NoSuchElementException.
Returns:
the value described by this OptionalLong
Throws:
public boolean isPresent |
() |
If a value is present, returns
true, otherwise
false.
Returns:
true if a value is present, otherwise false
public boolean isEmpty |
() |
If a value is not present, returns
true, otherwise
false.
Returns:
true if a value is not present, otherwise false
Since:
11
If a value is present, performs the given action with the value,
otherwise does nothing.
Parameters:
action - the action to be performed, if a value is present
Throws:
public void ifPresentOrElse |
|
If a value is present, performs the given action with the value,
otherwise performs the given empty-based action.
Parameters:
action - the action to be performed, if a value is present
emptyAction - the empty-based action to be performed, if no value is
present
Throws:
NullPointerException - if a value is present and the given action
is
null, or no value is present and the given empty-based
action is
null.
Since:
9
If a value is present, returns a sequential
LongStream containing
only that value, otherwise returns an empty
LongStream.
Returns:
the optional value as an LongStream
Since:
9
public long orElse |
(long other) |
If a value is present, returns the value, otherwise returns
other.
Parameters:
other - the value to be returned, if no value is present
Returns:
the value, if present, otherwise other
If a value is present, returns the value, otherwise returns the result
produced by the supplying function.
Parameters:
supplier - the supplying function that produces a value to be returned
Returns:
the value, if present, otherwise the result produced by the
supplying function
Throws:
public long orElseThrow |
() |
If a value is present, returns the value, otherwise throws
NoSuchElementException.
Returns:
the value described by this OptionalLong
Throws:
Since:
10
If a value is present, returns the value, otherwise throws an exception
produced by the exception supplying function.
Type Parameters:
X - Type of the exception to be thrown
Parameters:
exceptionSupplier - the supplying function that produces an
exception to be thrown
Returns:
the value, if present
Throws:
X - if no value is present
Indicates whether some other object is "equal to" this
OptionalLong. The other object is considered equal if:
- it is also an OptionalLong and;
- both instances have no value present or;
- the present values are "equal to" each other via ==.
Overrides:
Parameters:
obj - an object to be tested for equality
Returns:
true if the other object is "equal to" this object
otherwise false
See Also:
Returns the hash code of the value, if present, otherwise
0
(zero) if no value is present.
Overrides:
Returns:
hash code value of the present value or 0 if no value is
present
See Also:
Returns a non-empty string representation of this
OptionalLong
suitable for debugging. The exact presentation format is unspecified and
may vary between implementations and versions.
Implementation Requirements:
If a value is present the result must include its string representation
in the result. Empty and present OptionalLongs must be
unambiguously differentiable.
Overrides:
Returns:
the string representation of this instance
|
|
|
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |
FlexDoc/Javadoc is a template-driven programming tool for rapid development of any Javadoc-based Java API documentation generators (i.e. doclets). If you need to customize your Javadoc without writing a full-blown doclet from scratch,
FlexDoc/Javadoc may be the only tool able to help you! Find out more at
www.flexdoc.xyz