Класс scala.util.Either

Проверка двух объектов на неравенство.

Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для числовых типов возвращает значение хэша, которое соответствует равенству значений: если два экземпляра типа значения сравниваются как true, то ## вернёт одинаковое значение хэша для каждого из них. Для null возвращает хэш-код, где null.hashCode генерирует NullPointerException.

Выражение x == that эквивалентно if (x eq null) that eq null else x.equals(that).

Преобразует объект-получатель к типу T0.

Обратите внимание, что успех преобразования во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] вызовет ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] этого не сделает. В последнем примере, поскольку тип аргумента стирается при компиляции, невозможно проверить, соответствуют ли значения в списке требуемому типу.

Создаёт копию объекта-получателя.

По умолчанию реализация метода clone зависит от платформы.

Возвращает true если это Right и его значение равно elem (как определено ==), в противном случае возвращает false.

// Returns true because value of Right is "something" which equals "something".
Right("something") contains "something"

// Returns false because value of Right is "something" which does not equal "anything".
Right("something") contains "anything"

// Returns false because it's not a Right value.
Left("something") contains "something"

Проверяет, является ли аргумент (that) ссылкой на объект-получатель (this).

Метод eq реализует отношение эквивалентности на не-нулевых экземплярах AnyRef, и имеет три дополнительных свойства:

Он согласован: для любых не-нулевых экземпляров x и y типа AnyRef, многократные вызовы x.eq(y) последовательно возвращают true или последовательно возвращают false.Для любого не-нулевого экземпляра x типа AnyRef, x.eq(null) и null.eq(x) возвращают false. null.eq(null) возвращает true.

При переопределении методов equals или hashCode важно обеспечить согласованность их поведения с равенством по ссылке. Поэтому, если два объекта являются ссылками друг на друга (o1 eq o2), они должны быть равны друг другу (o1 == o2) и они должны хэшироваться к одному значению (o1.hashCode == o2.hashCode).

Метод равенства для ссылочных типов. Реализация по умолчанию делегирует в eq.

См. также equals в scala.Any.

Возвращает false если Left или возвращает результат применения заданного предиката к значению Right.

Right(12).exists(_ > 10)   // true
Right(7).exists(_ > 10)    // false
Left(12).exists(_ => true) // false

Возвращает Right с существующим значением Right если это Right и заданный предикат p выполняется для правого значения, или Left(zero) если это Right и заданный предикат p не выполняется для правого значения, или Left с существующим значением Left если это Left.

Right(12).filterOrElse(_ > 10, -1)   // Right(12)
Right(7).filterOrElse(_ > 10, -1)    // Left(-1)
Left(7).filterOrElse(_ => false, -1) // Left(7)

Вызывается сборщиком мусора для объекта-получателя, когда больше нет ссылок на объект.

Детали о том, когда и если вызывается метод finalize, а также взаимодействие finalize и нелокальных возвратов и исключений зависят от платформы.

Связывает заданную функцию с Right.

Применяет fa если это Left или fb если это Right.

Возвращает true если Left или возвращает результат применения данного предиката к значению Right.

Right(12).forall(_ > 10)    // true
Right(7).forall(_ > 10)     // false
Left(12).forall(_ => false) // true

Выполняет заданную функцию с побочным эффектом, если это Right.

Right(12).foreach(println) // prints "12"
Left(12).foreach(println)  // doesn't print

Возвращает строку, отформатированную в соответствии с заданной format строкой. Строки формата аналогичны String.format (@см. java.lang.String.format).

Возвращает представление класса объекта в среде выполнения.

Возвращает значение из этого Right или заданный аргумент, если это Left.

Right(12).getOrElse(17) // 12
Left(12).getOrElse(17)  // 17

Метод hashCode для ссылочных типов. См. hashCode в scala.Any.

Проверяет, является ли динамический тип объекта получателя T0.

Обратите внимание, что результат проверки выполняется по модулю семантики стирания Scala. Поэтому выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку аргумент типа стёрт во время компиляции, проверить, являются ли элементы списка указанного типа, невозможно.

Объединяет Either через Left.

Этот метод требует, чтобы левая сторона этого Either была типом Either. То есть, это должно быть что-то вроде:

Either[Either[C, B], B]

(что учитывает границы типа, показанные ниже.)

Если этот экземпляр является Left[Either[C, B]] , то будет возвращено содержащееся Either[C, B] , в противном случае это значение будет возвращено без изменений.

Left[Either[Int, String], String](Right("flower")).joinLeft // Result: Right("flower")
Left[Either[Int, String], String](Left(12)).joinLeft // Result: Left(12)
Right[Either[Int, String], String]("daisy").joinLeft // Result: Right("daisy")

Этот метод, и joinRight, аналогичны Option#flatten.

Присоединяет Either к Right.

Этот метод требует, чтобы правая часть этого Either сама была типа Either. То есть, это должен быть какой-то тип, например:

Either[A, Either[A, C]]

(который учитывает границы типа параметров, показанные ниже.)

Если этот экземпляр является Right[Either[A, C]], то будет возвращено содержимое Either[A, C], иначе это значение будет возвращено без изменений.

Проектирует этот Either как Left.

Это позволяет использовать for-циклы над левой стороной Either экземпляров, изменяя обычную правостороннюю предвзятость Either.

Например

for (s <- Left("flower").left) yield s.length // Left(6)

Продолжая аналогию с scala.Option, LeftProjection объявляет, что Left должен быть аналогом Some в некотором коде.

// using Option
def interactWithDB(x: Query): Option[Result] =
  try Some(getResultFromDatabase(x))
  catch {
    case _: SQLException => None
  }

// this will only be executed if interactWithDB returns a Some
val report = for (result <- interactWithDB(someQuery)) yield generateReport(result)
report match {
  case Some(r) => send(r)
  case None    => log("report not generated, not sure why...")
}

// using Either
def interactWithDB(x: Query): Either[Exception, Result] =
  try Right(getResultFromDatabase(x))
  catch {
    case e: SQLException => Left(e)
  }

 // run a report only if interactWithDB returns a Right
 val report = for (result <- interactWithDB(someQuery)) yield generateReport(result)
 report match {
   case Right(r) => send(r)
   case Left(e)  => log(s"report not generated, reason was $e")
 }
 // only report errors
 for (e <- interactWithDB(someQuery).left) log(s"query failed, reason was $e")

Применяется заданная функция, если это Right.

Right(12).map(x => "flower") // Result: Right("flower")
Left(12).map(x => "flower")  // Result: Left(12)

Эквивалентно !(this eq that).

Разбуждает единственную нить, которая ожидает монитора объекта-получателя.

Разбуждает все нити, которые ожидают монитора объекта-получателя.

Итератор по всем элементам этого произведения.

Строка, используемая в toString методах производных классов. Реализации могут переопределять этот метод, чтобы добавить префикс строки к результату toString методов.

Проектирует этот Either как Right.

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

Если это Left, возвращает левое значение в Right или наоборот.

Возвращает Some, содержащую значение Right в случае его наличия или None, если это Left.

Right(12).toOption // Some(12)
Left(12).toOption  // None

Возвращает Seq содержащую значение Right в случае его наличия или пустую Seq если это Left.

Right(12).toSeq // Seq(12)
Left(12).toSeq  // Seq()

Создает строковое представление этого объекта. Стандартное представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.