模块  java.base
软件包  java.util

Class OptionalLong


  • public final class OptionalLong
    extends Object
    容器对象,可能包含也可能不包含long值。 如果存在值, isPresent()将返回true 如果没有值,则该对象被视为isPresent()返回false

    提供了依赖于是否存在包含值的其他方法,例如orElse() (如果不存在值则返回默认值)和ifPresent() (如果存在值则执行操作)。

    这是一个value-based类; OptionalLong实例上使用身份敏感操作(包括引用相等( == ),标识哈希码或同步)可能会产生不可预测的结果,应该避免使用。

    API Note:
    OptionalLong主要用作方法返回类型,明确需要表示“无结果”。 类型为OptionalLong变量本身不应该是null ; 它应始终指向OptionalLong实例。
    从以下版本开始:
    1.8
    • 方法摘要

      所有方法  静态方法  实例方法 具体的方法 
      变量和类型 方法 描述
      static OptionalLong empty()
      返回一个空的 OptionalLong实例。
      boolean equals​(Object obj)
      指示某个其他对象是否“等于”此 OptionalLong
      long getAsLong()
      如果存在值,则返回该值,否则抛出 NoSuchElementException
      int hashCode()
      返回值的哈希码(如果存在),否则 0 (零)(如果不存在值)。
      void ifPresent​(LongConsumer action)
      如果存在值,则使用值执行给定操作,否则不执行任何操作。
      void ifPresentOrElse​(LongConsumer action, Runnable emptyAction)
      如果存在值,则使用值执行给定操作,否则执行给定的基于空的操作。
      boolean isEmpty()
      如果值不存在,则返回 true ,否则返回 false
      boolean isPresent()
      如果存在值,则返回 true ,否则返回 false
      static OptionalLong of​(long value)
      返回描述给定值的 OptionalLong
      long orElse​(long other)
      如果存在值,则返回该值,否则返回 other
      long orElseGet​(LongSupplier supplier)
      如果存在值,则返回该值,否则返回由供应函数生成的结果。
      long orElseThrow()
      如果存在值,则返回该值,否则抛出 NoSuchElementException
      <X extends Throwable>
      long
      orElseThrow​(Supplier<? extends X> exceptionSupplier)
      如果存在值,则返回该值,否则抛出异常提供函数生成的异常。
      LongStream stream()
      如果存在值,则返回仅包含该值的顺序LongStream ,否则返回空LongStream
      String toString()
      返回适合调试的 OptionalLong的非空字符串表示形式。
    • 方法详细信息

      • empty

        public static OptionalLong empty()
        返回一个空的OptionalLong实例。 OptionalLong没有值。
        API Note:
        虽然它可能是很有诱惑力的话,避免测试如果一个对象是通过比较空==对抗返回实例OptionalLong.empty() 无法保证它是单身人士。 相反,请使用isPresent()
        结果
        OptionalLong
      • of

        public static OptionalLong of​(long value)
        返回描述给定值的 OptionalLong
        参数
        value - 要描述的值
        结果
        OptionalLong
      • getAsLong

        public long getAsLong()
        如果存在值,则返回该值,否则抛出 NoSuchElementException
        API Note:
        该方法的优选替代方案是 orElseThrow()
        结果
        OptionalLong描述的值
        异常
        NoSuchElementException - 如果没有值
      • isPresent

        public boolean isPresent()
        如果存在值,则返回 true ,否则返回 false
        结果
        true如果存在值,否则为 false
      • isEmpty

        public boolean isEmpty()
        如果值不存在,则返回 true ,否则返回 false
        结果
        true如果不存在值,否则为 false
        从以下版本开始:
        11
      • ifPresent

        public void ifPresent​(LongConsumer action)
        如果存在值,则使用值执行给定操作,否则不执行任何操作。
        参数
        action - 如果存在值,则执行的操作
        异常
        NullPointerException - 如果存在值且给定操作为 null
      • ifPresentOrElse

        public void ifPresentOrElse​(LongConsumer action,
                                    Runnable emptyAction)
        如果存在值,则使用值执行给定操作,否则执行给定的基于空的操作。
        参数
        action - 如果存在值,则执行的操作
        emptyAction - 如果没有值,则执行基于空的操作
        异常
        NullPointerException - 如果存在值且给定操作为 null ,或者不存在任何值且给定的基于空的操作为 null
        从以下版本开始:
        9
      • stream

        public LongStream stream()
        如果存在值,则返回仅包含该值的顺序LongStream ,否则返回空LongStream
        API Note:
        此方法可用于将Stream的可选long LongStream为当前longs的LongStream
           Stream<OptionalLong> os = .. LongStream s = os.flatMapToLong(OptionalLong::stream)  
        结果
        可选值为 LongStream
        从以下版本开始:
        9
      • orElse

        public long orElse​(long other)
        如果存在值,则返回该值,否则返回 other
        参数
        other - 如果没有值,则返回值
        结果
        值,如果存在,否则 other
      • orElseGet

        public long orElseGet​(LongSupplier supplier)
        如果存在值,则返回该值,否则返回由供应函数生成的结果。
        参数
        supplier - 生成要返回的值的供应函数
        结果
        值,如果存在,否则由供应函数产生的结果
        异常
        NullPointerException - 如果没有值且供应功能为 null
      • orElseThrow

        public long orElseThrow()
        如果存在值,则返回该值,否则抛出 NoSuchElementException
        结果
        OptionalLong描述的值
        异常
        NoSuchElementException - 如果没有值
        从以下版本开始:
        10
      • orElseThrow

        public <X extends Throwable> long orElseThrow​(Supplier<? extends X> exceptionSupplier)
                                               throws X extends Throwable
        如果存在值,则返回该值,否则抛出异常提供函数生成的异常。
        API Note:
        具有空参数列表的异常构造函数的方法引用可用作供应商。 例如, IllegalStateException::new
        参数类型
        X - 要抛出的异常的类型
        参数
        exceptionSupplier - 生成要抛出的异常的供应函数
        结果
        价值,如果存在
        异常
        X - 如果没有值
        NullPointerException - 如果不存在值且异常提供功能为 null
        X extends Throwable
      • equals

        public boolean equals​(Object obj)
        指示某个其他对象是否“等于”此OptionalLong 如果符合以下条件,则认为另一个对
        • 它也是OptionalLong和;
        • 两个实例都没有价值或;
        • 目前的值通过==相互“等于”。
        重写:
        equals在类 Object
        参数
        obj - 要进行相等性测试的对象
        结果
        true如果另一个对象“等于”此对象,否则为 false
        另请参见:
        Object.hashCode()HashMap
      • toString

        public String toString()
        返回适合调试的OptionalLong的非空字符串表示形式。 确切的表示格式未指定,可能在实现和版本之间有所不同。
        重写:
        toString在类 Object
        实现要求:
        如果存在值,则结果必须在结果中包含其字符串表示形式。 空的和现在的OptionalLong必须是明确可区分的。
        结果
        此实例的字符串表示形式