Класс scala.runtime.AbstractPartialFunction

абстрактный класс AbstractPartialFunction[@specialized -T1, @specialized +R] extends T1 => R with PartialFunction[T1, R]

AbstractPartialFunction переформулирует все операции своего супертрейта PartialFunction в терминах isDefinedAt и applyOrElse.

Это позволяет в многих случаях получить более эффективные реализации: - оптимизированный метод orElse поддерживает цепочки orElse за линейное время и без замедления, если часть orElse не требуется. - оптимизированный метод lift помогает избежать двойной оценки матчеров шаблонов и условий частичной функции-литерала.

Этот трейт используется в качестве основы для реализации всех частичных функций-литералов.

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

Исходный код

def apply(x: T1): R

Наследованные методы

Исходный код

def andThen[C](k: PartialFunction[R, C]): PartialFunction[T1, C]

Компонует эту частичную функцию с другой частичной функцией, которая применяется к результатам этой частичной функции.

Обратите внимание, что вызов isDefinedAt на полученной частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Для повышения эффективности рекомендуется вызывать applyOrElse вместо isDefinedAt или apply.

Исходный код

override def andThen[C](k: R => C): PartialFunction[T1, C]

Компонует эту частичную функцию с функцией преобразования, которая применяется к результатам этой частичной функции.

Если тип функции во время выполнения является PartialFunction, то используется другой метод andThen (обратите внимание на его предостережения).

Исходный код

def applyOrElse[A1 <: T1, B1 >: R](x: A1, default: A1 => B1): B1

Применяет эту частичную функцию к заданному аргументу, если он содержится в области определения функции. Применяет функцию по умолчанию, если эта частичная функция не определена.

Обратите внимание, что выражение pf.applyOrElse(x, default) эквивалентно

if(pf isDefinedAt x) pf(x) else default(x)

за исключением того, что метод applyOrElse может быть реализован более эффективно. Для всех частичных функций-литералов компилятор генерирует реализацию applyOrElse, которая позволяет избежать двойной оценки матчеров шаблонов и условий. Это делает applyOrElse основой для эффективной реализации во многих операциях и сценариях, таких как:

- объединение частичных функций в цепочки orElse/andThen не приводит к излишней apply/isDefinedAt оценке - lift и unlift не оценивают исходные функции дважды при каждом вызове - runWith позволяет эффективно объединять частичные функции с условными действиями

Для классов частичных функций, не являющихся литералами, с нетривиальным методом isDefinedAt, рекомендуется переопределять метод applyOrElse с пользовательской реализацией, которая избегает двойной isDefinedAt оценки. Это может привести к лучшей производительности и более предсказуемому поведению относительно побочных эффектов.

Исходный код

def compose[R](k: PartialFunction[R, T1]): PartialFunction[R, R]

Компонует другую частичную функцию k с этой частичной функцией таким образом, что эта частичная функция применяется к результатам k.

Обратите внимание, что вызов isDefinedAt на полученной частичной функции может применить первую частичную функцию и выполнить её побочный эффект. Для повышения эффективности рекомендуется вызывать applyOrElse вместо isDefinedAt или apply.

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

def compose[A](g: A => T1): A => R

Компонует две части Function1 в новую Function1, применяя эту функцию последней.

Исходный код

def elementWise: ElementWiseExtractor[T1, R]

Возвращает объект-экстрактор с методом unapplySeq, который извлекает каждый элемент данных последовательности.

val firstChar: String => Option[Char] = _.headOption
Seq("foo", "bar", "baz") match {
  case firstChar.unlift.elementWise(c0, c1, c2) =>
    println(s"$c0, $c1, $c2") // Output: f, b, b
}

Исходный код

def isDefinedAt(x: T1): Boolean

Проверяет, содержится ли значение в области определения функции.

Исходный код

def lift: T1 => Option[R]

Преобразует эту частичную функцию в простую функцию, возвращающую результат Option.

Исходный код

def orElse[A1 <: T1, B1 >: R](that: PartialFunction[A1, B1]): PartialFunction[A1, B1]

Компонует эту частичную функцию со вспомогательной частичной функцией, которая применяется там, где эта частичная функция не определена.

Исходный код

def runWith[U](action: R => U): T1 => Boolean

Компонует эту частичную функцию с функцией действия, которая применяется к результатам этой частичной функции. Функция действия вызывается только для своих побочных эффектов; ее результат игнорируется.

Обратите внимание, что выражение pf.runWith(action)(x) эквивалентно

if(pf isDefinedAt x) { action(pf(x)); true } else false

за исключением того, что runWith реализовано с помощью applyOrElse и, следовательно, потенциально более эффективно. Использование runWith позволяет избежать двойной оценки шаблонов сопоставления и условий для литералов частичных функций.

Исходный код

override def toString(): String

Исходный код

def unapply(a: T1): Option[R]

Попытка извлечь B из A в выражении сопоставления с образцом.