Объект scala.None

@SerialVersionUID(5066590221178148012L)

case object None extends Option[Nothing]

Этот объект case представляет отсутствующие значения.

Наследуемые классы

Исходный код

Класс WithFilter(p: A => Boolean)

Нам нужен весь класс WithFilter, чтобы соблюсти контракт «не создаёт новую коллекцию», даже если это маловероятно, что будет иметь значение в коллекции с максимальным размером 1.

Наследуемые типы

Исходный код

Тип MirroredElemLabels = EmptyTuple

Исходный код

Тип MirroredElemTypes = EmptyTuple

Исходный код

Тип MirroredLabel <: String

Имя типа

Исходный код

Тип MirroredMonoType = Singleton

Исходный код

Тип MirroredType = Singleton

Конкретные методы

Исходный код

def get: Nothing

Наследуемые методы

Исходный код@inline

final def collect[B](pf: PartialFunction[Nothing, B]): Option[B]

Возвращает scala.Some, содержащий результат применения pf к этому значению scala.Option, если этот параметр не пустой, и pf определено для этого значения. В противном случае возвращает 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 the option is empty. There is no value to pass to the partial function.
None collect {case value => value}

Исходный код

final def contains[A1](elem: A1): Boolean

Проверяет, содержит ли параметр данное значение в качестве элемента.

Это эквивалентно:

option match {
 case Some(x) => x == elem
 case None    => false
}

// 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"

Исходный код@inline

final def exists(p: Nothing => Boolean): Boolean

Возвращает true, если этот параметр не пустой, и предикат p возвращает true, когда применяется к значению этого scala.Option. В противном случае возвращает false.

Это эквивалентно:

option match {
 case Some(x) => p(x)
 case None    => false
}

Исходный код@inline

final def filter(p: Nothing => Boolean): Option[Nothing]

Возвращает этот scala.Option, если он не пустой, и применение предиката p к значению этого scala.Option возвращает true. В противном случае возвращает None.

Это эквивалентно:

option match {
 case Some(x) if p(x) => Some(x)
 case _               => None
}

Исходный код@inline

final def filterNot(p: Nothing => Boolean): Option[Nothing]

Возвращает этот scala.Option, если он не пустой, и применение предиката p к значению этого scala.Option возвращает false. В противном случае возвращает None.

Это эквивалентно:

option match {
 case Some(x) if !p(x) => Some(x)
 case _                => None
}

Исходный код@inline

final def flatMap[B](f: Nothing => Option[B]): Option[B]

Возвращает результат применения f к значению этого scala.Option, если этот scala.Option не пустой. Возвращает None , если этот scala.Option пустой. Несколько отличается от map, так как ожидается, что f вернёт scala.Option (который может быть None).

Это эквивалентно:

option match {
 case Some(x) => f(x)
 case None    => None
}

Исходный код

def flatten[B](implicit ev: Nothing <:< Option[B]): Option[B]

Возвращает вложенное значение scala.Option, если оно не пустое. В противном случае возвращает None.

Это эквивалентно:

option match {
 case Some(Some(b)) => Some(b)
 case _             => None
}

Some(Some("something")).flatten

Исходный код@inline

final def fold[B](ifEmpty: => B)(f: Nothing => B): B

Возвращает результат применения f к значению этого scala.Option, если scala.Option не пусто. В противном случае вычисляет выражение ifEmpty.

Это эквивалентно:

option match {
 case Some(x) => f(x)
 case None    => ifEmpty
}

Это также эквивалентно:

option map f getOrElse ifEmpty

Исходный код@inline

final def forall(p: Nothing => Boolean): Boolean

Возвращает true, если этот параметр пустой или предикат p возвращает true, когда применяется к значению этого scala.Option.

Это эквивалентно:

option match {
 case Some(x) => p(x)
 case None    => true
}

Исходный код@inline

final def foreach[U](f: Nothing => U): Unit

Применяет заданную процедуру f к значению параметра, если он не пустой. В противном случае ничего не делает.

Это эквивалентно:

option match {
 case Some(x) => f(x)
 case None    => ()
}

Исходный код

def fromProduct(p: Product): MirroredMonoType

Исходный код@inline

final def getOrElse[B](default: => B): B

Возвращает значение параметра, если параметр не пустой, в противном случае возвращает результат вычисления default.

Это эквивалентно:

option match {
 case Some(x) => x
 case None    => default
}

Исходный код

final def isDefined: Boolean

Возвращает true, если параметр является экземпляром scala.Some, в противном случае false.

Это эквивалентно:

option match {
 case Some(_) => true
 case None    => false
}

Исходный код

final def isEmpty: Boolean

Возвращает true, если параметр None, в противном случае false.

Это эквивалентно:

option match {
 case Some(_) => false
 case None    => true
}

Исходный код

def iterator: Iterator[Nothing]

Возвращает итератор с одиночным элементом, возвращающим значение scala.Option, если он не пуст, или пустой итератор, если параметр пустой.

Исходный код

final override def knownSize: Int

Исходный код@inline

final def map[B](f: Nothing => B): Option[B]

Возвращает scala.Some содержащий результат применения f к значению этого scala.Option, если этот scala.Option не пуст. В противном случае возвращает None.

Это эквивалентно:

option match {
 case Some(x) => Some(f(x))
 case None    => None
}

Исходный код

final def nonEmpty: Boolean

Возвращает false, если параметр None, в противном случае true.

Это эквивалентно:

option match {
 case Some(_) => true
 case None    => false
}

Исходный код@inline

final def orElse[B](alternative: => Option[B]): Option[B]

Возвращает этот scala.Option, если он не пуст, в противном случае возвращает результат вычисления alternative.

Это эквивалентно:

option match {
 case Some(x) => Some(x)
 case None    => alternative
}

Исходный код@inline

final def orNull[A1](implicit ev: Null <:< A1): A1

Возвращает значение параметра, если он не пуст, или null если он пуст.

Хотя использование null не рекомендуется, код, написанный для использования scala.Option, часто должен взаимодействовать с кодом, который ожидает и возвращает null.

Это эквивалентно:

option match {
 case Some(x) => x
 case None    => null
}

val initialText: Option[String] = getInitialText
val textField = new JComponent(initialText.orNull,20)

Исходный код

def productElementNames: Iterator[String]

Итератор по именам всех элементов этого продукта.

Исходный код

def productIterator: Iterator[Any]

Итератор по всем элементам этого продукта.

Исходный код

def stepper[S <: Stepper[_]](implicit shape: StepperShape[Nothing, S]): S

Возвращает scala.collection.Stepper для элементов этого набора.

Stepper позволяет создать Java-поток для обработки коллекции, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper может использоваться в качестве итератора, который не упаковывает элементы.

Неявный параметр scala.collection.StepperShape определяет тип возвращаемого Stepper в соответствии с типом элементов этой коллекции.

• Для коллекций Int, Short, Byte или Char, возвращается scala.collection.IntStepper

• Для коллекций Double или Float, возвращается scala.collection.DoubleStepper

• Для коллекций Long возвращается scala.collection.LongStepper

• Для любого другого типа элементов возвращается scala.collection.AnyStepper

Обратите внимание, что этот метод переопределен в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, scala.collection.IndexedSeqOps.stepper. Для Steppers, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Steppers могут быть преобразованы только в последовательные потоки.

Источник@inline

final def toLeft[X](right: => X): Either[Nothing, X]

Возвращает scala.util.Right, содержащую переданный аргумент right , если этот объект пустой, или scala.util.Left, содержащую значение этого scala.Option, если этот scala.Option непустой.

Это эквивалентно:

option match {
 case Some(x) => Left(x)
 case None    => Right(right)
}

Источник

def toList: List[Nothing]

Возвращает список, содержащий единственный элемент — значение scala.Option, если он не пустой, или пустой список, если scala.Option пустой.

Это эквивалентно:

option match {
 case Some(x) => List(x)
 case None    => Nil
}

Источник@inline

final def toRight[X](left: => X): Either[X, Nothing]

Возвращает scala.util.Left, содержащую переданный аргумент left , если этот scala.Option пустой, или scala.util.Right, содержащую значение этого scala.Option, если он непустой.

Это эквивалентно:

option match {
 case Some(x) => Right(x)
 case None    => Left(left)
}

Источник

final def unzip[A1, A2](implicit asPair: Nothing <:< (A1, A2)): (Option[A1], Option[A2])

Преобразует Option пары в Option первого элемента и Option второго элемента.

Это эквивалентно:

option match {
  case Some((x, y)) => (Some(x), Some(y))
  case _            => (None,    None)
}

Источник

final def unzip3[A1, A2, A3](implicit asTriple: Nothing <:< (A1, A2, A3)): (Option[A1], Option[A2], Option[A3])

Преобразует Option тройки в три Option, каждый из которых содержит элемент из соответствующей позиции тройки.

Это эквивалентно:

option match {
  case Some((x, y, z)) => (Some(x), Some(y), Some(z))
  case _               => (None,    None,    None)
}

Источник@inline

final def withFilter(p: Nothing => Boolean): WithFilter

Необходим для предотвращения неявного преобразования scala.Option в scala.collection.Iterable в for выражениях.

Источник

final def zip[A1, B](that: Option[B]): Option[(A1, B)]

Возвращает scala.Some, образованный из этого Option и другого Option путём объединения соответствующих элементов в пару. Если один из двух Options пустой, возвращается None.

Это эквивалентно:

(option1, option2) match {
  case (Some(x), Some(y)) => Some((x, y))
  case _                  => None
}

// Returns Some(("foo", "bar")) because both options are nonempty.
Some("foo") zip Some("bar")
// Returns None because `that` option is empty.
Some("foo") zip None
// Returns None because `this` option is empty.
None zip Some("bar")