Аннотация scala.deprecated

класс deprecated extends Annotation with StaticAnnotation

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

Авторы библиотек должны указать политику устаревания своей библиотеки в документации, чтобы дать разработчикам руководство по тому, как долго будет сохраняться устаревшее определение.

Авторы библиотек должны добавлять имя своей библиотеки перед номером версии, чтобы помочь разработчикам различать устаревания, исходящие из разных библиотек:

@deprecated("this method will be removed", "FooLib 12.0")
def oldMethod(x: Int) = ...

Компилятор будет выводить предупреждения об устаревании, сгруппированные по библиотеке и версии:

oldMethod(1)
oldMethod(2)
aDeprecatedMethodFromLibraryBar(3, 4)

// warning: there was one deprecation warning (since BarLib 3.2)
// warning: there were two deprecation warnings (since FooLib 12.0)
// warning: there were three deprecation warnings in total; re-run with -deprecation for details

@deprecated в языке Scala и его стандартной библиотеке

Устаревший элемент языка Scala или определение в стандартной библиотеке Scala будет сохраняться по крайней мере для текущей основной версии.

Это означает, что элемент, устаревший в какой-то версии 2.13.x, будет сохранён во всех версиях 2.13.x, но может быть удалён в версии 2.14. (Устаревший элемент может быть сохранён дольше, чтобы облегчить миграцию, но разработчики не должны полагаться на это.)

Аннотации: @getter() @setter() @beanGetter() @beanSetter() @deprecatedInheritance("Планируется финальным в 2.14", "2.13.0")
Источник: deprecated.scala
С: 2.3
См. также: Официальная документация по бинарной совместимости.
scala.deprecatedInheritance
scala.deprecatedOverriding
scala.deprecatedName
Линейные надтипы: StaticAnnotation, Annotation, AnyRef, Any

Члены-значения

final def !=(arg0: Any): Boolean

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

returns: true если !(this == that), в противном случае false.

Definition Classes: AnyRef → Any

final def ##(): Int

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

returns: хэш-значение, согласованное с ==

Definition Classes: AnyRef → Any

def +(other: String): String

Implicit: Этот член добавлен неявным преобразованием из deprecated в any2stringadd[deprecated] с помощью метода any2stringadd в scala.Predef.
Definition Classes: any2stringadd

def ->[B](y: B): (deprecated, B)

Implicit: Этот член добавлен неявным преобразованием из deprecated в ArrowAssoc[deprecated] с помощью метода ArrowAssoc в scala.Predef.
Definition Classes: ArrowAssoc
Annotations: @inline()

final def ==(arg0: Any): Boolean

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

returns: true если объект-получатель эквивалентен аргументу; false в противном случае.

Definition Classes: AnyRef → Any

final def asInstanceOf[T0]: T0

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

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

returns: объект-получатель.

Definition Classes: Any
Исключения: ClassCastException, если объект-получатель не является экземпляром стирания типа T0.

def clone(): AnyRef

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

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

returns: копия объекта-получателя.

Attributes: protected[java.lang]
Definition Classes: AnyRef
Annotations: @throws(classOf[java.lang.CloneNotSupportedException]) @native()
Примечание: не определено SLS как член AnyRef

def ensuring(cond: (deprecated) => Boolean, msg: => Any): deprecated

Implicit: Этот член добавлен неявным преобразованием из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: (deprecated) => Boolean): deprecated

Implicit: Этот член добавлен неявным преобразованием из deprecated в Ensuring[deprecated] с помощью метода Ensuring в scala.Predef.
Definition Classes: Ensuring

def ensuring(cond: Boolean, msg: => Any): deprecated

Неявный: Этот член добавлен неявным преобразованием из deprecated вEnsuring[deprecated] с помощью метода Ensuring в scala.Predef.
Классы определений: Ensuring

def ensuring(cond: Boolean): deprecated

Неявный: Этот член добавлен неявным преобразованием из deprecated вEnsuring[deprecated] с помощью метода Ensuring в scala.Predef.
Классы определений: Ensuring

final def eq(arg0: AnyRef): Boolean

Проверяет, является ли аргумент (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).

возвращает: true если аргумент является ссылкой на объект-приемник; false в противном случае.

Классы определений: AnyRef

def equals(arg0: AnyRef): Boolean

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

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

возвращает: true если объект-приемник эквивалентен аргументу; false в противном случае.

Классы определений: AnyRef → Any

def finalize(): Unit

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

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

Атрибуты: protected[java.lang]
Классы определений: AnyRef
Аннотации: @throws(classOf[java.lang.Throwable])
Примечание: не специфицировано SLS в качестве члена AnyRef

def formatted(fmtstr: String): String

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

Неявный: Этот член добавлен неявным преобразованием из deprecated вStringFormat[deprecated] с помощью метода StringFormat в scala.Predef.
Классы определений: StringFormat
Аннотации: @inline()

final def getClass(): Class[_ <: AnyRef]

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

возвращает: объект класса, соответствующий типу runtime-объекта.

Классы определений: AnyRef → Any
Аннотации: @native()

def hashCode(): Int

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

возвращает: значение хэш-кода для этого объекта.

Классы определений: AnyRef → Any
Аннотации: @native()

final def isInstanceOf[T0]: Boolean

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

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

возвращает: true если объект-приемник является экземпляром стираемого типа T0; false в противном случае.

Классы определений: Any

final def ne(arg0: AnyRef): Boolean

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

возвращает: true если аргумент не является ссылкой на объект получателя; false в противном случае.

Классы определений: AnyRef

final def notify(): Unit

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

Классы определений: AnyRef
Аннотации: @native()
Примечание: не указано SLS как член AnyRef

final def notifyAll(): Unit

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

Классы определений: AnyRef
Аннотации: @native()
Примечание: не указано SLS как член AnyRef

final def synchronized[T0](arg0: => T0): T0

Классы определений: AnyRef

def toString(): String

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

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

Классы определений: AnyRef → Any

final def wait(): Unit

Классы определений: AnyRef
Аннотации: @throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long, arg1: Int): Unit

Классы определений: AnyRef
Аннотации: @throws(classOf[java.lang.InterruptedException])

final def wait(arg0: Long): Unit

Классы определений: AnyRef
Аннотации: @throws(classOf[java.lang.InterruptedException]) @native()

© 2002-2019 EPFL, with contributions from Lightbend.
Licensed under the Apache License, Version 2.0.
https://www.scala-lang.org/api/2.13.0/scala/deprecated.html