|
|
|
SUMMARY: NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD |
|
FlexDoc/Javadoc 2.0 Demo Java Doc |
Class OptionalInt
java.util.OptionalInt
public final class OptionalInt
A container object which may or may not contain an
int 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 OptionalInt instance.
|
boolean |
Indicates whether some other object is "equal to" this
OptionalInt.
|
int |
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 OptionalInt describing the given value.
|
int |
If a value is present, returns the value, otherwise returns
other.
|
int |
If a value is present, returns the value, otherwise returns the result
produced by the supplying function.
|
int |
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 IntStream containing
only that value, otherwise returns an empty IntStream.
|
|
Returns a non-empty string representation of this OptionalInt
suitable for debugging.
|
Methods inherited from class java.lang. Object |
|
Returns an empty
OptionalInt instance. No value is present for
this
OptionalInt.
Returns:
an empty OptionalInt
Returns an
OptionalInt describing the given value.
Parameters:
value - the value to describe
Returns:
an OptionalInt with the value present
If a value is present, returns the value, otherwise throws
NoSuchElementException.
Returns:
the value described by this OptionalInt
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
IntStream containing
only that value, otherwise returns an empty
IntStream.
Returns:
the optional value as an IntStream
Since:
9
public int orElse |
(int 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 int orElseThrow |
() |
If a value is present, returns the value, otherwise throws
NoSuchElementException.
Returns:
the value described by this OptionalInt
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
OptionalInt. The other object is considered equal if:
- it is also an OptionalInt 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
OptionalInt
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 OptionalInts 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