Класс scala.collection.immutable.MapOps.ImmutableKeySet
класс ImmutableKeySet extends AbstractSet[K] with GenKeySet with DefaultSerializable
Конструкторы экземпляров
new ImmutableKeySet()
Члены значения
final def !=(arg0: Any): Boolean
Проверка двух объектов на неравенство.
- returns
trueif !(this == that), false otherwise.
- Определяющие классы
- AnyRef → Any
final def ##(): Int
Эквивалентно x.hashCode за исключением упакованных числовых типов и null. Для чисел он возвращает хэш-значение, которое согласуется с равенством значений: если два экземпляра типа значения сравниваются как true, то ## будет генерировать одно и то же хэш-значение для каждого из них. Для null возвращает хэш-код, где null.hashCode вызывает NullPointerException.
- returns
хэш-значение, согласованное с ==
- Определяющие классы
- AnyRef → Any
final def &(that: collection.Set[K]): Set[K]
final def &~(that: collection.Set[K]): Set[K]
final def +(elem: K): Set[K]
final def ++(that: IterableOnce[K]): Set[K]
final def ++[B >: K](suffix: IterableOnce[B]): Set[B]
Псевдоним для concat
- Определяющие классы
- IterableOps
- Аннотации
- @inline()
final def -(elem: K): Set[K]
final def --(that: IterableOnce[K]): Set[K]
def ->[B](y: B): (ImmutableKeySet, B)
- Неявный
- Этот член добавляется неявным преобразованием из ImmutableKeySet в ArrowAssoc[ImmutableKeySet], выполняемым методом ArrowAssoc в scala.Predef.
- Определяющие классы
- ArrowAssoc
- Аннотации
- @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 addString(b: mutable.StringBuilder): mutable.StringBuilder
Добавляет все элементы этой коллекции в строковый буфер. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции без разделительной строки.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> val h = a.addString(b) h: StringBuilder = 1234
- b
строковый буфер, в который добавляются элементы.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
final def addString(b: mutable.StringBuilder, sep: String): mutable.StringBuilder
Добавляет все элементы этой коллекции в строковый буфер с использованием разделительной строки. Записываемый текст состоит из строковых представлений (относительно метода toString) всех элементов этой коллекции, разделенных строкой sep.
Пример:
scala> val a = List(1,2,3,4) a: List[Int] = List(1, 2, 3, 4) scala> val b = new StringBuilder() b: StringBuilder = scala> a.addString(b, ", ") res0: StringBuilder = 1, 2, 3, 4
- b
строковый буфер, в который добавляются элементы.
- sep
разделительная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def addString(b: mutable.StringBuilder, start: String, sep: String, end: String): mutable.StringBuilder
Добавляет все элементы этой коллекции в строковый буфер с использованием начальной, конечной и разделительной строк. Записываемый текст начинается со строки start и заканчивается строкой end. Внутри строковые представления (относительно метода toString) всех элементов этой коллекции разделены строкой sep.
Пример:
scala> val a = List(1,2,3,4)
a: List[Int] = List(1, 2, 3, 4)
scala> val b = new StringBuilder()
b: StringBuilder =
scala> a.addString(b , "List(" , ", " , ")")
res5: StringBuilder = List(1, 2, 3, 4)
- b
строковый буфер, в который добавляются элементы.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковый буфер
b, в который были добавлены элементы.
- Definition Classes
- IterableOnceOps
def andThen[A](g: (Boolean) => A): (K) => A
Компонует два экземпляра Function1 в новый Function1, применяя данный метод в первую очередь.
- A
тип результата функции
g- g
функция R => A
- returns
новая функция
fтакая, чтоf(x) == g(apply(x))
- Definition Classes
- Function1
- Annotations
- @unspecialized()
final def apply(elem: K): Boolean
Проверяет, содержится ли какой-либо элемент в этом множестве.
Этот метод эквивалентен contains. Он позволяет рассматривать множества как предикаты.
- elem
элемент для проверки на членство.
- returns
trueеслиelemсодержится в этом множестве,falseв противном случае.
final def asInstanceOf[T0]: T0
Приведение объекта-получателя к типу T0.
Обратите внимание, что успех приведения во время выполнения зависит от семантики стирания Scala. Поэтому выражение 1.asInstanceOf[String] выбросит ClassCastException во время выполнения, в то время как выражение List(1).asInstanceOf[List[String]] — нет. В последнем примере из-за того, что аргумент типа стирается при компиляции, невозможно проверить, содержат ли элементы списка нужный тип.
- returns
объект-получатель.
- Definition Classes
- Any
- Исключения
ClassCastException, если объект-получатель не является экземпляром стирания типаT0.
def canEqual(that: Any): Boolean
Метод, который следует вызывать из каждого хорошо спроектированного метода equals, который открыт для переопределения в подклассе. См. Программирование на Scala, глава 28 для обсуждения и проектирования.
- that
значение, проверяемое на возможное равенство
- возвращает
true, если этот экземпляр может быть равен
that, в противном случае false
def className: String
Определяет префикс представления этого объекта toString.
Рекомендуется возвращать имя конкретного типа коллекции, но не подклассы реализации. Например, для ListMap этот метод должен возвращать "ListMap", а не "Map" (супертип) или "Node" (подкласс реализации).
По умолчанию реализация возвращает "Iterable". Она переопределена для основных видов коллекций "Seq", "IndexedSeq", "LinearSeq", "Buffer", "Set", "Map", "SortedSet", "SortedMap" и "View".
- возвращает
строковое представление, которое начинается с результата
toString, примененного к этой итерируемой коллекции. По умолчанию строковый префикс — это простое имя класса коллекции итерируемой коллекции.
- Атрибуты
- protected[this]
- Классы определений
- Iterable
def clone(): AnyRef
Создает копию объекта-получателя.
По умолчанию реализация метода clone зависит от платформы.
- возвращает
копию объекта-получателя.
final def coll: ImmutableKeySet.this.type
- возвращает
Эту коллекцию в виде
C.
- Атрибуты
- protected
- Классы определений
- Iterable → IterableOps
def collect[B](pf: PartialFunction[K, B]): Set[B]
Создает новую итерируемую коллекцию, применяя частичную функцию ко всем элементам этой итерируемой коллекции, для которых функция определена.
- B
тип элемента возвращаемой итерируемой коллекции.
- pf
частичная функция, которая фильтрует и отображает итерируемую коллекцию.
- возвращает
новая итерируемая коллекция, полученная в результате применения данной частичной функции
pfк каждому элементу, для которого она определена, и сбора результатов. Порядок элементов сохраняется.
- Классы определений
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода нужно отбросить итератор, на котором он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def collectFirst[B](pf: PartialFunction[K, B]): Option[B]
Ищет первый элемент коллекции, для которого заданная частичная функция определена, и применяет частичную функцию к нему.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- pf
частичная функция
- возвращает
значение типа Option, содержащее результат применения pf к первому значению, для которого она определена, или
None, если такового нет.
- Классы определений
- IterableOnceOps
Seq("a", 1, 5L).collectFirst({ case x: Int => x*10 }) = Some(10)
def compose[A](g: (A) => K): (A) => Boolean
Компонует два экземпляра Function1 в новый Function1, при этом эта функция применяется последней.
- A
тип, к которому можно применить функцию
g- g
функция A => T1
- возвращает
новая функция
fтакая, чтоf(x) == apply(g(x))
- Классы определений
- Function1
- Аннотации
- @unspecialized()
def concat(that: IterableOnce[K]): Set[K]
Создает новое множество, добавляя все элементы, содержащиеся в другой коллекции в это множество, опуская дубликаты.
Этот метод принимает коллекцию элементов и добавляет все элементы, опуская дубликаты, в множество.
Пример:
scala> val a = Set(1, 2) concat Set(2, 3) a: scala.collection.immutable.Set[Int] = Set(1, 2, 3)
- that
коллекция, содержащая элементы для добавления.
- возвращает
новое множество с добавленными элементами, опуская дубликаты.
- Классы определений
- SetOps
def concat[B >: K](suffix: IterableOnce[B]): Set[B]
Возвращает новую итерируемую коллекцию, содержащую элементы из левого операнда, за которыми следуют элементы из правого операнда. Тип элементов итерируемой коллекции является наиболее специфическим суперклассом, охватывающим типы элементов двух операндов.
- B
тип элементов возвращаемой коллекции.
- suffix
траверсабельный объект для добавления.
- returns
новая итерируемая коллекция, которая содержит все элементы этой итерируемой коллекции, за которыми следуют все элементы
suffix.
- Определяющие классы
- IterableOps
def contains(key: K): Boolean
- Определяющие классы
- GenKeySet
def copyToArray[B >: K](xs: Array[B], start: Int, len: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start не более чем len элементами этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива, или будет скопировано len элементов.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- len
максимальное количество элементов для копирования.
- returns
количество элементов, записанных в массив
- Определяющие классы
- IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван. Его использование не определено и может быть изменено. Примечание: не будет завершаться для коллекций бесконечного размера.
def copyToArray[B >: K](xs: Array[B], start: Int): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- start
начальный индекс xs.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def copyToArray[B >: K](xs: Array[B]): Int
Копирует элементы в массив, возвращая количество записанных элементов.
Заполняет данный массив xs начиная с индекса start значениями этой коллекции.
Копирование прекратится, как только будут скопированы все элементы этой коллекции, или будет достигнут конец массива.
- B
тип элементов массива.
- xs
массив для заполнения.
- returns
количество элементов, записанных в массив Примечание: не будет завершаться для коллекций бесконечного размера.
- Определяющие классы
- IterableOnceOps
def corresponds[B](that: IterableOnce[B])(p: (K, B) => Boolean): Boolean
Проверяет, удовлетворяет ли каждый элемент итератора этой коллекции соотношению с соответствующим элементом другой коллекции, удовлетворяя тестовому предикату.
- B
тип элементов
that- that
другая коллекция
- p
тестовый предикат, который связывает элементы из обеих коллекций
- returns
trueесли обе коллекции имеют одинаковую длину иp(x, y)являетсяtrueдля всех соответствующих элементовxэтого итератора иyизthat, иначеfalse
- Определяющие классы
- IterableOnceOps
def count(p: (K) => Boolean): Int
Подсчитывает количество элементов в коллекции, которые удовлетворяют предикату.
- p
предикат, используемый для проверки элементов.
- returns
количество элементов, удовлетворяющих предикату
p.
- Определяющие классы
- IterableOnceOps
def diff(that: collection.Set[K]): Set[K]
Вычисляет разность этого множества и другого множества.
- that
множество элементов, которые нужно исключить.
- returns
множество, содержащее те элементы этого множества, которые также не содержатся в заданном множестве
that.
def drop(n: Int): Set[K]
Выбирает все элементы, кроме первых n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов, которые нужно удалить из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме первых
nэлементов, или пустой итерируемый набор, если этот итерируемый набор содержит менееnэлементов. Еслиnотрицательно, то не удалять ни одного элемента.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода необходимо отказаться от итератора, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def dropRight(n: Int): Set[K]
Выбирает все элементы, кроме последних n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- n
количество элементов, которые нужно удалить из этого итерируемого набора.
- returns
итерируемый набор, состоящий из всех элементов этого итерируемого набора, кроме последних
nэлементов, или пустой итерируемый набор, если этот итерируемый набор содержит менееnэлементов. Еслиnотрицательно, то не удалять ни одного элемента.
- Definition Classes
- IterableOps
def dropWhile(p: (K) => Boolean): Set[K]
Удаляет самую длинную префиксную последовательность элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен.
- p
Предикат для проверки элементов.
- returns
самый длинный суффикс этого итерируемого набора, первый элемент которого не удовлетворяет предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода необходимо отказаться от итератора, на котором он был вызван, и использовать только итератор, который был возвращен. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def empty: Set[K]
Пустой итерируемый набор того же типа, что и этот итерируемый набор
- returns
пустой итерируемый набор типа
C.
- Definition Classes
- IterableFactoryDefaults → IterableOps
def ensuring(cond: (ImmutableKeySet) => Boolean, msg: => Any): ImmutableKeySet
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableKeySet в Ensuring[ImmutableKeySet] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: (ImmutableKeySet) => Boolean): ImmutableKeySet
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableKeySet в Ensuring[ImmutableKeySet] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean, msg: => Any): ImmutableKeySet
- Implicit
- Этот член добавлен неявным преобразованием из ImmutableKeySet в Ensuring[ImmutableKeySet] с помощью метода Ensuring в scala.Predef.
- Definition Classes
- Ensuring
def ensuring(cond: Boolean): ImmutableKeySet
- Неявный
- Этот член добавляется неявным преобразованием из ImmutableKeySet в Ensuring[ImmutableKeySet] с помощью метода 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(that: Any): Boolean
Универсальный метод равенства, определенный в AnyRef.
def excl(elem: K): Set[K]
Создаёт новый набор, из которого удален указанный элемент.
- elem
элемент, который нужно удалить
- возвращает
новый набор, содержащий все элементы этого набора, но не содержащий
elem.
- Определяющие классы
- ImmutableKeySet → SetOps
def exists(p: (K) => Boolean): Boolean
Проверяет, выполняется ли предикат по крайней мере для одного элемента этого набора.
Примечание: может не завершиться для наборов бесконечного размера.
- p
предикат для проверки элементов.
- возвращает
trueесли заданный предикатpудовлетворяется по крайней мере одним элементом этого набора, в противном случаеfalse
- Определяющие классы
- IterableOnceOps
def filter(pred: (K) => Boolean): Set[K]
Выбирает все элементы этого итерируемого набора, которые удовлетворяют предикату.
- возвращает
новый итератор, состоящий из всех элементов этого итерируемого набора, удовлетворяющих заданному предикату
p. Порядок элементов сохраняется.
- Определяющие классы
- IterableOps → IterableOnceOps
def filterNot(pred: (K) => Boolean): Set[K]
Выбирает все элементы этого итерируемого набора, которые не удовлетворяют предикату.
- pred
предикат для проверки элементов.
- возвращает
новый итерируемый набор, состоящий из всех элементов этого итерируемого набора, которые не удовлетворяют заданному предикату
pred. Порядок элементов может быть не сохранён.
- Определяющие классы
- IterableOps → IterableOnceOps
def finalize(): Unit
Вызывается сборщиком мусора на объекте-получателе, когда больше нет ссылок на объект.
Подробности о том, когда и если вызывается метод finalize, а также взаимодействие finalize с нелокальными возвратами и исключениями, зависят от платформы.
def find(p: (K) => Boolean): Option[K]
Находит первый элемент коллекции, удовлетворяющий предикату, если таковой существует.
Примечание: может не завершиться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
опциональное значение, содержащее первый элемент в коллекции, который удовлетворяет
p, илиNone, если такового не существует.
- Определяющие классы
- IterableOnceOps
def flatMap[B](f: (K) => IterableOnce[B]): Set[B]
Создает новую итерируемую коллекцию, применяя функцию ко всем элементам этой итерируемой коллекции и используя элементы результирующих коллекций.
Например:
def getWords(lines: Seq[String]): Seq[String] = lines flatMap (line => line split "\\W+")
Тип результирующей коллекции определяется статическим типом итерируемой коллекции. Это иногда может приводить к неожиданным результатам. Например:
// lettersOf will return a Seq[Char] of likely repeated letters, instead of a Set
def lettersOf(words: Seq[String]) = words flatMap (word => word.toSet)
// lettersOf will return a Set[Char], not a Seq
def lettersOf(words: Seq[String]) = words.toSet flatMap ((word: String) => word.toSeq)
// xs will be an Iterable[Int]
val xs = Map("a" -> List(11,111), "b" -> List(22,222)).flatMap(_._2)
// ys will be a Map[Int, Int]
val ys = Map("a" -> List(1 -> 11,1 -> 111), "b" -> List(2 -> 22,2 -> 222)).flatMap(_._2)
- B
тип элемента возвращаемой коллекции.
- f
функция, применяемая к каждому элементу.
- returns
новая итерируемая коллекция, полученная в результате применения заданной функции со значениями в виде коллекции
fк каждому элементу этой итерируемой коллекции и конкатенации результатов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def flatten[B](implicit asIterable: (K) => IterableOnce[B]): Set[B]
Преобразует эту итерируемую коллекцию итерируемых коллекций в итерируемую коллекцию, образованную элементами этих итерируемых коллекций.
Тип результирующей коллекции будет определяться типом итерируемой коллекции. Например:
val xs = List(
Set(1, 2, 3),
Set(1, 2, 3)
).flatten
// xs == List(1, 2, 3, 1, 2, 3)
val ys = Set(
List(1, 2, 3),
List(3, 2, 1)
).flatten
// ys == Set(1, 2, 3)
- B
тип элементов каждой итерируемой коллекции.
- asIterable
неявное преобразование, которое утверждает, что тип элемента этой итерируемой коллекции является
GenTraversable.- returns
новая итерируемая коллекция, полученная путем конкатенации всех итерируемых коллекций элементов.
- Определяющие классы
- IterableOps → IterableOnceOps
- Примечание
Повторное использование: после вызова этого метода следует отбросить итератор, к которому он был вызван, и использовать только возвращенный итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
def fold[A1 >: K](z: A1)(op: (A1, A1) => A1): A1
Сворачивает элементы этой коллекции, используя указанный ассоциативный бинарный оператор. Реализация по умолчанию в IterableOnce эквивалентна foldLeft, но может быть переопределена для более эффективных порядков обхода.
Порядок, в котором операции выполняются над элементами, не указан и может быть недетерминированным.
Примечание: не будет завершаться для коллекций бесконечного размера.
- A1
тип параметра для бинарного оператора, надтип
A.- z
нейтральный элемент для операции сворачивания; может быть добавлен к результату произвольное количество раз и не должен изменять результат (например,
Nilдля конкатенации списков, 0 для сложения или 1 для умножения).- op
бинарный оператор, который должен быть ассоциативным.
- returns
результат применения оператора сворачивания
opмежду всеми элементами иz, илиz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldLeft[B](z: B)(op: (B, K) => B): B
Применяет бинарный оператор к начальному значению и всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо, с начальным значениемzслева:op(...op(z, x_1), x_2, ..., x_n)
где
x1, ..., xn- элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def foldRight[B](z: B)(op: (K, B) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции и начальному значению, справа налево.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- z
начальное значение.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этой коллекции, справа налево, с начальным значениемzсправа:op(x_1, op(x_2, ... op(x_n, z)...))
где
x1, ..., xn- элементы этой коллекции. Возвращаетz, если эта коллекция пуста.
- Определяющие классы
- IterableOnceOps
def forall(p: (K) => Boolean): Boolean
Проверяет, выполняется ли предикат для всех элементов этого набора.
Примечание: может не завершиться для наборов бесконечной длины.
- p
предикат, используемый для проверки элементов.
- returns
trueесли этот набор пуст или заданный предикатpвыполняется для всех элементов этого набора, в противном случаеfalse.
- Definition Classes
- IterableOnceOps
def foreach[U](f: (K) => U): Unit
Применяет f к каждому элементу для его побочных эффектов. Примечание: параметр [U] необходим для помощи в процессе вывода типов scalac.
- Definition Classes
- IterableOnceOps
def formatted(fmtstr: String): String
Возвращает строку, отформатированную в соответствии с заданной format строкой. Форматные строки аналогичны String.format (@см. java.lang.String.format).
- Неявный
- Этот член добавлен с помощью неявного преобразования из ImmutableKeySet вStringFormat[ImmutableKeySet] выполненное методом StringFormat в scala.Predef.
- Definition Classes
- StringFormat
- Аннотации
- @inline()
def fromSpecific(coll: IterableOnce[K]): Set[K]
Определяет, как преобразовать заданный Iterable[A] в коллекцию типа C.
Этот процесс может быть выполнен строго или нестрого (т. е. без оценки элементов результирующих коллекций). Другими словами, этот метод определяет модель оценки коллекции.
- Атрибуты
- protected
- Definition Classes
- IterableFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа этот метод необходимо переопределить (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, добавив трейт IterableFactoryDefaults, который реализует метод с помощью iterableFactory.Как показывает аннотация
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, пока он вызывается сIterable[A], полученным отthisколлекции (как это происходит в реализациях операций, где мы используемView[A]), он безопасен.
final def getClass(): Class[_ <: AnyRef]
Возвращает представление runtime-класса объекта.
- returns
объект класса, соответствующий типу получателя runtime.
def groupBy[K](f: (K) => K): Map[K, Set[K]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с некоторой функцией-дискриминатором.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- K
тип ключей, возвращаемых функцией-дискриминатором.
- f
функция-дискриминатор.
- returns
-
Карта, где ключи сопоставлены с итерируемыми коллекциями, удовлетворяющими следующему инварианту:
(xs groupBy f)(k) = xs filter (x => f(x) == k)
То есть каждый ключ
kсвязан с итерируемой коллекцией тех элементовx, для которыхf(x)равноk.
- Definition Classes
- IterableOps
def groupMap[K, B](key: (K) => K)(f: (K) => B): Map[K, Set[B]]
Разделяет эту итерируемую коллекцию на карту итерируемых коллекций в соответствии с функцией-дискриминатором key. Каждый элемент в группе преобразуется в значение типа B с помощью функции value.
Эквивалентно groupBy(key).mapValues(_.map(f)), но более эффективно.
case class User(name: String, age: Int) def namesByAge(users: Seq[User]): Map[Int, Seq[String]] = users.groupMap(_.age)(_.name)
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- K
тип ключей, возвращаемых функцией-дискриминатором
- B
тип значений, возвращаемых функцией преобразования
- key
функция-дискриминатор
- f
функция преобразования элементов
- Definition Classes
- IterableOps
def groupMapReduce[K, B](key: (K) => K)(f: (K) => B)(reduce: (B, B) => B): Map[K, B]
Разделяет эту итерируемую коллекцию на карту по функции дискриминатора key. Все значения, имеющие одинаковый дискриминатор, затем преобразуются функцией value и затем сводятся к одному значению с помощью функции reduce.
Это эквивалентно groupBy(key).mapValues(_.map(f).reduce(reduce)), но более эффективно.
def occurrences[A](as: Seq[A]): Map[A, Int] = as.groupMapReduce(identity)(_ => 1)(_ + _)
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- Definition Classes
- IterableOps
def grouped(size: Int): Iterator[Set[K]]
Разделяет элементы в итерируемых коллекциях фиксированного размера.
- size
количество элементов в группе
- returns
Итератор, производящий итерируемые коллекции размером
size, за исключением последней, которая будет меньше sizesize, если элементы не делятся равномерно.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
grouped
def hashCode(): Int
Метод hashCode для ссылочных типов. См. hashCode в scala.Any.
- returns
значение хэш-кода для этого объекта.
def head: K
Выбирает первый элемент этой итерируемой коллекции.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции.
- Definition Classes
- IterableOps
- Исключения
NoSuchElementException, если итерируемая коллекция пуста.
def headOption: Option[K]
Необязательно выбирает первый элемент.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- returns
первый элемент этой итерируемой коллекции, если она непуста,
Noneесли она пуста.
- Definition Classes
- IterableOps
def incl(elem: K): Set[K]
Создаёт новый набор с добавлением элемента, если элемент ещё не присутствует.
- elem
добавляемый элемент
- returns
новый набор, содержащий все элементы данного набора и также содержащий
elem.
- Definition Classes
- ImmutableKeySet → SetOps
def init: Set[K]
Начальная часть коллекции без последнего элемента.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- Definition Classes
- IterableOps
def inits: Iterator[Set[K]]
Итерируется по начальным частям этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее - пустой итерируемой коллекцией, а промежуточные значения - результаты последовательного применения init.
Примечание: Даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
- returns
итератор по всем начальным частям этой итерируемой коллекции
- Definition Classes
- IterableOps
List(1,2,3).inits = Iterator(List(1,2,3), List(1,2), List(1), Nil)
def intersect(that: collection.Set[K]): Set[K]
Вычисляет пересечение между этим набором и другим набором.
- that
набор для пересечения.
- returns
новый набор, состоящий из всех элементов, которые присутствуют как в этом наборе, так и в заданном наборе
that.
- Definition Classes
- SetOps
def isEmpty: Boolean
- Definition Classes
- GenKeySet
final def isInstanceOf[T0]: Boolean
Проверить, является ли динамический тип объекта-получателя T0.
Обратите внимание, что результат проверки зависит от семантики стирания Scala. Таким образом, выражение 1.isInstanceOf[String] вернёт false, а выражение List(1).isInstanceOf[List[String]] вернёт true. В последнем примере, поскольку тип аргумента стирается во время компиляции, невозможно проверить, являются ли элементы списка указанного типа.
- returns
true, если объект-получатель является экземпляром стираемого типаT0;falseв противном случае.
- Definition Classes
- Any
def isTraversableAgain: Boolean
Проверка, можно ли многократно пройти по этому итерируемому набору. Всегда истинно для Iterable и ложно для Iterator, если не переопределено.
- returns
true, если можно многократно пройти по итерируемому набору,falseв противном случае.
- Definition Classes
- IterableOps → IterableOnceOps
def iterableFactory: IterableFactory[Set]
Компаньон-объект этого неизменяемого множества, предоставляющий различные методы создания экземпляров.
- Definition Classes
- Set → Set → Iterable → Iterable → IterableOps
- Note
При реализации пользовательского типа коллекции и уточнении
CCдо нового типа, необходимо переопределить этот метод, чтобы вернуть фабрику для нового типа (в противном случае компилятор выдаст ошибку).
def iterator: Iterator[K]
- Definition Classes
- GenKeySet
def knownSize: Int
- Definition Classes
- GenKeySet
def last: K
Выбор последнего элемента.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
Последний элемент этого итерируемого набора.
- Definition Classes
- IterableOps
- Exceptions thrown
NoSuchElementExceptionЕсли итерируемый набор пуст.
def lastOption: Option[K]
Возможный выбор последнего элемента.
Примечание: может возвращать разные результаты при разных запусках, если тип базовой коллекции не упорядочен.
- returns
последний элемент этого итерируемого набора, если он не пустой,
Noneесли он пустой.
- Definition Classes
- IterableOps
def lazyZip[B](that: collection.Iterable[B]): LazyZip2[K, B, ImmutableKeySet.this.type]
Аналог zip за исключением того, что элементы в каждой коллекции не потребляются до тех пор, пока на возвращённом LazyZip2 декораторе не вызвана строгая операция.
Вызовы lazyZip могут быть объединены для поддержки более высокого числа аргументов (до 4) без издержек на создание и деконструкцию промежуточных кортежей.
val xs = List(1, 2, 3) val res = (xs lazyZip xs lazyZip xs lazyZip xs).map((a, b, c, d) => a + b + c + d) // res == List(4, 8, 12)
- B
тип второго элемента в каждой возможной паре
- that
итерируемый набор, предоставляющий второй элемент каждой возможной пары
- returns
декоратор
LazyZip2, позволяющий выполнять строгие операции над лениво вычисляемыми парами или объединёнными вызовамиlazyZip. Поддерживается также неявное преобразование вIterable[(A, B)].
- Definition Classes
- Iterable
def map[B](f: (K) => B): Set[B]
Строит новый итерируемый набор, применяя функцию ко всем элементам этого итерируемого набора.
- B
тип элемента возвращаемого итерируемого набора.
- f
функция, применяемая к каждому элементу.
- returns
новый итерируемый набор, полученный путём применения данной функции
fк каждому элементу этого итерируемого набора и сборки результатов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода нужно отбросить итератор, на котором он был вызван, и использовать только тот итератор, который был возвращён. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе тоже.
def max[B >: K](implicit ord: math.Ordering[B]): K
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxBy[B](f: (K) => B)(implicit cmp: math.Ordering[B]): K
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def maxByOption[B](f: (K) => B)(implicit cmp: math.Ordering[B]): Option[K]
Находит первый элемент, который дает наибольшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наибольшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def maxOption[B >: K](implicit ord: math.Ordering[B]): Option[K]
Находит наибольший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее наибольший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
def min[B >: K](implicit ord: math.Ordering[B]): K
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, используемый для сравнения элементов.
- returns
наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minBy[B](f: (K) => B)(implicit cmp: math.Ordering[B]): K
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def minByOption[B](f: (K) => B)(implicit cmp: math.Ordering[B]): Option[K]
Находит первый элемент, который дает наименьшее значение, измеренное функцией f.
- B
Тип результата функции f.
- f
Функция измерения.
- cmp
Порядок, используемый для сравнения элементов.
- returns
необязательное значение, содержащее первый элемент этой коллекции с наименьшим значением, измеренным функцией f относительно порядка
cmp.
- Определяющие классы
- IterableOnceOps
def minOption[B >: K](implicit ord: math.Ordering[B]): Option[K]
Находит наименьший элемент.
- B
Тип, для которого определен порядок.
- ord
Порядок, который будет использоваться для сравнения элементов.
- returns
необязательное значение, содержащее наименьший элемент этой коллекции относительно порядка
ord.
- Определяющие классы
- IterableOnceOps
final def mkString: String
Отображает все элементы этой коллекции в строке.
Делегирует addString, который может быть переопределен.
- returns
строковое представление этой коллекции. В результирующей строке строковые представления (относительно метода
toString) всех элементов этой коллекции следуют друг за другом без какой-либо разделительной строки.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
final def mkString(sep: String): String
Отображает все элементы этой коллекции в строке, используя разделительную строку.
Делегирует addString, который может быть переопределен.
- sep
разделительная строка.
- returns
строковое представление этой коллекции. В результирующей строке строковые представления (относительно метода
toString) всех элементов этой коллекции разделены строкойsep.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @inline()
List(1, 2, 3).mkString("|") = "1|2|3"
final def mkString(start: String, sep: String, end: String): String
Отображает все элементы этой коллекции в строке, используя начальные, конечные и разделительные строки.
Делегирует addString, который может быть переопределен.
- start
начальная строка.
- sep
разделительная строка.
- end
конечная строка.
- returns
строковое представление этой коллекции. Результирующая строка начинается со строки
startи заканчивается строкойend. Внутри, строковые представления (относительно методаtoString) всех элементов этой коллекции разделены строкойsep.
- Определяющие классы
- IterableOnceOps
List(1, 2, 3).mkString("(", "; ", ")") = "(1; 2; 3)"
final def ne(arg0: AnyRef): Boolean
Эквивалентно !(this eq that).
- returns
trueесли аргумент не является ссылкой на принимающий объект;falseв противном случае.
- Определяющие классы
- AnyRef
def newSpecificBuilder: Builder[K, Set[K]]
- returns
строгий строитель для того же типа коллекции. Обратите внимание, что в случае ленивых коллекций (например, View или immutable.LazyList), можно реализовать этот метод, но результирующий
Builderнарушит леность. Вследствие этого операции предпочтительно должны быть реализованы с помощьюfromSpecificвместо этого метода.
- Атрибуты
- protected
- Определяющие классы
- IterableFactoryDefaults → IterableOps
- Примечание
-
При реализации пользовательского типа коллекции и уточнении
,Cдо нового типа, этот метод должен быть переопределен (в противном случае компилятор выдаст ошибку). В общем случае, когдаC =:= CC[A], это можно сделать, включив черту IterableFactoryDefaults, которая реализует метод с помощью iterableFactory.Как показано аннотацией
@uncheckedVariance, использование этого метода может быть небезопасным. Однако, пока возвращаемый строитель заполняется только значениямиA, взятыми из экземпляраthis, он безопасен.
def nonEmpty: Boolean
Проверяет, не пуста ли коллекция.
- returns
trueесли коллекция содержит хотя бы один элемент,falseв противном случае.
- Определяющие классы
- IterableOnceOps
- Аннотации
- @deprecatedOverriding("nonEmpty определяется как !isEmpty; переопределите isEmpty вместо этого", "2.13.0")
final def notify(): Unit
Будит один поток, ожидающий на мониторе принимающего объекта.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано SLS как член AnyRef
final def notifyAll(): Unit
Будит все потоки, ожидающие на мониторе объекта-получателя.
- Определяющие классы
- AnyRef
- Аннотации
- @native()
- Примечание
не указано в SLS как член AnyRef
def partition(p: (K) => Boolean): (Set[K], Set[K])
Пара из, во-первых, всех элементов, удовлетворяющих предикату p и, во-вторых, всех элементов, которые этого не делают. Интересно, потому что это разделяет коллекцию на две части.
Предоставленная здесь реализация по умолчанию должна дважды пройти по коллекции. Строгие коллекции имеют переопределенную версию partition в StrictOptimizedIterableOps, которая требует только одного прохода.
- Определяющие классы
- IterableOps
def partitionMap[A1, A2](f: (K) => Either[A1, A2]): (Set[A1], Set[A2])
Применяет функцию f к каждому элементу итерируемой коллекции и возвращает пару итерируемых коллекций: первая состоит из тех значений, возвращаемых f, которые были заключены в scala.util.Left, а вторая - из тех, которые были заключены в scala.util.Right.
Пример:
val xs = Iterable(1, "one", 2, "two", 3, "three") partitionMap {
case i: Int => Left(i)
case s: String => Right(s)
}
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип элементов первой результирующей коллекции
- A2
тип элементов второй результирующей коллекции
- f
'Функция разделения', отображающая элементы этой итерируемой коллекции на scala.util.Either
- возвращает
пару итерируемых коллекций: первая состоит из тех значений, возвращаемых
f, которые были заключены в scala.util.Left, а вторая - из тех, которые были заключены в scala.util.Right.
- Определяющие классы
- IterableOps
def product[B >: K](implicit num: math.Numeric[B]): B
Перемножает элементы этой коллекции.
- B
результирующий тип оператора
*.- num
неявный параметр, определяющий набор числовых операций, который включает оператор
*, используемый для формирования произведения.- возвращает
произведение всех элементов этой коллекции относительно оператора
*вnum.
- Определяющие классы
- IterableOnceOps
def reduce[B >: K](op: (B, B) => B): B
Сводит элементы этой коллекции, используя указанный ассоциативный бинарный оператор.
Порядок, в котором выполняются операции над элементами, не указан и может быть недетерминированным.
- B
Параметр типа для бинарного оператора, супертип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- возвращает
Результат применения оператора reduce
opко всем элементам, если коллекция не пуста.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeft[B >: K](op: (B, K) => B): B
Применяет бинарный оператор ко всем элементам этой коллекции, слева направо.
Примечание: не будет завершаться для коллекций бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен или оператор не является ассоциативным и коммутативным.
- B
результирующий тип бинарного оператора.
- op
бинарный оператор.
- возвращает
-
результат вставки
opмежду последовательными элементами этой коллекции, слева направо:op( op( ... op(x_1, x_2) ..., x_{n-1}), x_n)где
x1, ..., xn- элементы этой коллекции.
- Определяющие классы
- IterableOnceOps
- Выбрасываемые исключения
UnsupportedOperationExceptionесли эта коллекция пуста.
def reduceLeftOption[B >: K](op: (B, K) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, слева направо.
Примечание: не завершится для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора не упорядочен или оператор не является ассоциативным и коммутативным.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение Option, содержащее результат
reduceLeft(op), если этот набор не пустой,None, в противном случае.
- Definition Classes
- IterableOnceOps
def reduceOption[B >: K](op: (B, B) => B): Option[B]
Сводит элементы этого набора, если таковые имеются, используя указанный ассоциативный бинарный оператор.
Порядок выполнения операций над элементами не определен и может быть не детерминированным.
- B
Параметр типа для бинарного оператора, надтип
A.- op
Бинарный оператор, который должен быть ассоциативным.
- returns
Значение типа Option, содержащее результат применения оператора reduce
opк всем элементам, если набор не пустой, иNoneв противном случае.
- Definition Classes
- IterableOnceOps
def reduceRight[B >: K](op: (K, B) => B): B
Применяет бинарный оператор ко всем элементам этого набора, справа налево.
Примечание: не завершится для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
-
результат вставки
opмежду последовательными элементами этого набора, справа налево:op(x_1, op(x_2, ..., op(x_{n-1}, x_n)...))где
x1, ..., xn— элементы этого набора.
- Definition Classes
- IterableOnceOps
- Exceptions thrown
UnsupportedOperationException, если этот набор пуст.
def reduceRightOption[B >: K](op: (K, B) => B): Option[B]
Необязательно применяет бинарный оператор ко всем элементам этого набора, справа налево.
Примечание: не завершится для наборов бесконечного размера.
Примечание: может возвращать разные результаты для разных запусков, если тип базового набора упорядочен или оператор ассоциативен и коммутативен.
- B
тип результата бинарного оператора.
- op
бинарный оператор.
- returns
значение Option, содержащее результат
reduceRight(op), если этот набор не пустой,Noneв противном случае.
- Definition Classes
- IterableOnceOps
def removedAll(that: IterableOnce[K]): Set[K]
Создаёт новый неизменяемый набор из этого неизменяемого набора, удаляя все элементы из другого набора.
- that
набор, содержащий элементы для удаления.
- returns
новый неизменяемый набор с удалёнными элементами, исключая дубликаты.
- Definition Classes
- SetOps
def reversed: collection.Iterable[K]
- Attributes
- protected
- Definition Classes
- IterableOnceOps
def scan[B >: K](z: B)(op: (B, B) => B): Set[B]
Вычисляет префиксный скан элементов набора.
Примечание: нейтральный элемент z может применяться более одного раза.
- B
тип элементов результирующего набора
- z
нейтральный элемент для оператора
op- op
ассоциативный оператор для сканирования
- returns
новый итерируемый набор, содержащий префиксный скан элементов в этом итерируемом наборе
- Definition Classes
- IterableOps
def scanLeft[B](z: B)(op: (B, K) => B): Set[B]
Производит итерируемую коллекцию, содержащую кумулятивные результаты применения оператора слева направо, включая начальное значение.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если только тип базовой коллекции не упорядочен.
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def scanRight[B](z: B)(op: (K, B) => B): Set[B]
Производит коллекцию, содержащую кумулятивные результаты применения оператора справа налево. Голова коллекции — последний кумулятивный результат.
Примечание: не завершится для коллекций бесконечного размера.
Примечание: может возвращать разные результаты при разных запусках, если только тип базовой коллекции не упорядочен.
Примечание: даже при применении к представлению или ленивой коллекции элементы всегда будут принудительно вычисляться.
Пример:
List(1, 2, 3, 4).scanRight(0)(_ + _) == List(10, 9, 7, 4, 0)
- B
тип элементов в результирующей коллекции
- z
начальное значение
- op
бинарный оператор, применяемый к промежуточному результату и элементу
- returns
коллекция с промежуточными результатами
- Definition Classes
- IterableOps
def size: Int
- Definition Classes
- GenKeySet
def sizeCompare(that: collection.Iterable[_]): Int
Сравнивает размер этой итерируемой коллекции с размером другой Iterable.
- that
Iterable, размер которой сравнивается с размером этой итерируемой коллекции.- returns
-
Значение
x, гдеx < 0 if this.size < that.size x == 0 if this.size == that.size x > 0 if this.size > that.size
Метод в данной реализации не вызывает
sizeнапрямую; его время выполнения составляетO(this.size min that.size)вместоO(this.size + that.size). Метод следует переопределять, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- IterableOps
def sizeCompare(otherSize: Int): Int
Сравнивает размер этой итерируемой коллекции со значением-тестом.
- otherSize
тестовое значение, которое сравнивается с размером.
- returns
-
Значение
x, гдеx < 0 if this.size < otherSize x == 0 if this.size == otherSize x > 0 if this.size > otherSize
Метод в данной реализации не вызывает
sizeнапрямую; его время выполнения составляетO(size min otherSize)вместоO(size). Метод следует переопределять, если вычислениеsizeявляется быстрым, иknownSizeвозвращает-1.
- Definition Classes
- IterableOps
- See also
final def sizeIs: SizeCompareOps
Возвращает значение класса, содержащего операции для сравнения размера этой итерируемой коллекции со значением-тестом.
Эти операции реализуются через sizeCompare(Int), и позволяют использовать более читабельный синтаксис:
this.sizeIs < size // this.sizeCompare(size) < 0 this.sizeIs <= size // this.sizeCompare(size) <= 0 this.sizeIs == size // this.sizeCompare(size) == 0 this.sizeIs != size // this.sizeCompare(size) != 0 this.sizeIs >= size // this.sizeCompare(size) >= 0 this.sizeIs > size // this.sizeCompare(size) > 0
- Definition Classes
- IterableOps
- Annotations
- @inline()
def slice(from: Int, until: Int): Set[K]
Выбирает интервал элементов. Результирующая итерируемая коллекция состоит из всех элементов x, которые удовлетворяют инварианту:
from <= indexOf(x) < until
Примечание: может возвращать разные результаты при разных запусках, если только тип базовой коллекции не упорядочен.
- from
наименьший индекс для включения из этой итерируемой коллекции.
- until
наименьший индекс для исключения из этой итерируемой коллекции.
- returns
итерируемая коллекция, содержащая элементы, большие или равные индексу
from, простираясь до (но не включая) индексuntilэтой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: после вызова этого метода следует удалить итератор, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def sliding(size: Int, step: Int): Iterator[Set[K]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» над ними (в отличие от разбиения, как это делается в grouped.)
- size
количество элементов в группе
- step
расстояние между первыми элементами последовательных групп
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def sliding(size: Int): Iterator[Set[K]]
Группирует элементы в блоки фиксированного размера, пропуская «скользящее окно» над ними (в отличие от разбиения, как это делается в grouped.) Шаг «скользящего окна» установлен в единицу.
- size
количество элементов в группе
- returns
Итератор, генерирующий итерируемые коллекции размера
size, за исключением последнего элемента (который может быть единственным элементом), который будет усечен, если оставшихся элементов для группировки меньше, чемsize.
- Definition Classes
- IterableOps
- See also
scala.collection.Iterator, метод
sliding
def span(p: (K) => Boolean): (Set[K], Set[K])
Разбивает эту итерируемую коллекцию на пару префикс/суффикс в соответствии с предикатом.
Примечание: c span p эквивалентно (но, возможно, более эффективно, чем) (c takeWhile p, c dropWhile p), при условии, что вычисление предиката p не вызывает побочных эффектов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
предикат проверки
- returns
пара, состоящая из самого длинного префикса этой итерируемой коллекции, элементы которой удовлетворяют
p, и остальной части этой итерируемой коллекции.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.
def splitAt(n: Int): (Set[K], Set[K])
Разделяет эту итерируемую коллекцию на пару префикс/суффикс в заданной позиции.
Примечание: c splitAt n эквивалентно (но, возможно, более эффективно, чем) (c take n, c drop n).
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
позиция, на которой нужно разделить.
- returns
пара итерируемых коллекций, состоящих из первых
nэлементов этой итерируемой коллекции и других элементов.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Переиспользование: После вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращенные итераторы. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новых итераторах тоже.
def stepper[S <: Stepper[_]](implicit shape: StepperShape[K, S]): S
Возвращает Stepper для элементов этой коллекции.
Stepper позволяет создавать Java-поток для работы с коллекцией, см. scala.jdk.StreamConverters. Для коллекций, содержащих примитивные значения, Stepper можно использовать как итератор, который не упаковывает элементы.
Неявный параметр StepperShape определяет тип результирующего Stepper в соответствии с типом элементов этой коллекции.
-
Для коллекций
Int, Short, Byte или Char, возвращается IntStepperДля коллекций Double или Float, возвращается DoubleStepperДля коллекций Long возвращается LongStepperДля любого другого типа элементов возвращается AnyStepperОбратите внимание, что этот метод переопределяется в подклассах, и тип возвращаемого значения уточняется до S with EfficientSplit, например, IndexedSeqOps.stepper. Для Stepper, помеченных scala.collection.Stepper.EfficientSplit, конвертеры в scala.jdk.StreamConverters позволяют создавать параллельные потоки, в то время как обычные Stepper можно преобразовать только в последовательные потоки.
- Definition Classes
- IterableOnce
def stringPrefix: String
- Attributes
- protected[this]
- Definition Classes
- Set → Iterable
- Annotations
- @deprecatedOverriding("Compatibility override", "2.13.0")
def subsetOf(that: collection.Set[K]): Boolean
Проверяет, является ли это множество подмножеством другого множества.
- that
множество для проверки.
- returns
trueесли это множество является подмножествомthat, т.е. если каждый элемент этого множества также является элементомthat.
- Definition Classes
- SetOps
def subsets(): Iterator[Set[K]]
def subsets(len: Int): Iterator[Set[K]]
Итератор по всем подмножествам этого множества заданного размера. Если запрашиваемый размер невозможен, возвращается пустой итератор.
- len
размер подмножеств.
- returns
итератор.
- Definition Classes
- SetOps
def sum[B >: K](implicit num: math.Numeric[B]): B
Суммирует элементы этой коллекции.
- B
тип результата оператора
+.- num
неявный параметр, определяющий набор числовых операций, который включает оператор
+, используемый для вычисления суммы.- returns
сумма всех элементов этой коллекции относительно оператора
+вnum.
- Definition Classes
- IterableOnceOps
final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
def tail: Set[K]
Остальная часть коллекции без её первого элемента.
- Definition Classes
- IterableOps
def tails: Iterator[Set[K]]
Итерируется по хвостам этой итерируемой коллекции. Первое значение будет этой итерируемой коллекцией, а последнее — пустой итерируемой коллекцией, а промежуточные значения — результаты последовательных применений tail.
- returns
итератор по всем хвостам этой итерируемой коллекции
- Definition Classes
- IterableOps
List(1,2,3).tails = Iterator(List(1,2,3), List(2,3), List(3), Nil)
def take(n: Int): Set[K]
Выбирает первые n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые нужно взять из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая только из первых
nэлементов этой итерируемой коллекции, или же вся итерируемая коллекция, если в ней меньшеnэлементов. Еслиnотрицательное, возвращает пустую итерируемую коллекцию.
- Definition Classes
- IterableOps → IterableOnceOps
- Примечание
Переиспользование: после вызова этого метода нужно отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может измениться и может привести к изменениям в новом итераторе.
def takeRight(n: Int): Set[K]
Выбирает последние n элементов.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- n
количество элементов, которые нужно взять из этой итерируемой коллекции.
- returns
итерируемая коллекция, состоящая только из последних
nэлементов этой итерируемой коллекции, или же вся итерируемая коллекция, если в ней меньшеnэлементов. Еслиnотрицательное, возвращает пустую итерируемую коллекцию.
- Definition Classes
- IterableOps
def takeWhile(p: (K) => Boolean): Set[K]
Берет самый длинный префикс элементов, удовлетворяющих предикату.
Примечание: может возвращать разные результаты для разных запусков, если тип базовой коллекции не упорядочен.
- p
Предикат, используемый для проверки элементов.
- returns
самый длинный префикс этой итерируемой коллекции, элементы которой удовлетворяют предикату
p.
- Definition Classes
- IterableOps → IterableOnceOps
def tapEach[U](f: (K) => U): Set[K]
Применяет функцию с побочным эффектом к каждому элементу в этой коллекции. Строгие коллекции применят f к своим элементам немедленно, в то время как ленивые коллекции, такие как представления и LazyLists, применят f к каждому элементу только тогда, когда этот элемент будет вычисляться, и каждый раз, когда этот элемент будет вычисляться.
- U
тип возвращаемого значения f
- f
функция, которая применяется к каждому элементу в этой итерируемой коллекции
- returns
Такая же логическая коллекция, как и эта
- Definition Classes
- IterableOps → IterableOnceOps
def to[C1](factory: Factory[K, C1]): C1
Используя фабрику коллекций factory, преобразуйте эту коллекцию в соответствующее представление для текущего типа элемента A. Примеры использования:
xs.to(List) xs.to(ArrayBuffer) xs.to(BitSet) // для xs: Iterable[Int]
- Definition Classes
- IterableOnceOps
def toArray[B >: K](implicit arg0: ClassTag[B]): Array[B]
Преобразовать коллекцию в массив.
- Definition Classes
- IterableOnceOps
final def toBuffer[B >: K]: Buffer[B]
- Definition Classes
- IterableOnceOps
- Annotations
- @inline()
def toIndexedSeq: IndexedSeq[K]
- Definition Classes
- IterableOnceOps
final def toIterable: ImmutableKeySet.this.type
- returns
Эта коллекция как
Iterable[A]. Новый сбор не будет создан, еслиthisуже являетсяIterable[A].
- Definition Classes
- Iterable → IterableOps
def toList: List[K]
- Definition Classes
- IterableOnceOps
def toMap[K, V](implicit ev: <:<[K, (K, V)]): Map[K, V]
- Definition Classes
- IterableOnceOps
def toSeq: Seq[K]
- returns
Эта коллекция в виде
Seq[A]. Это эквивалентноto(Seq), но может быть быстрее.
- Definition Classes
- IterableOnceOps
def toSet[B >: K]: Set[B]
- Definition Classes
- IterableOnceOps
def toString(): String
Создаёт строковое представление этого объекта. По умолчанию представление зависит от платформы. На платформе Java это конкатенация имени класса, «@» и хэш-кода объекта в шестнадцатеричном формате.
- returns
строковое представление объекта.
- Definition Classes
- Набор → Функция1 → Итерируемый → AnyRef → Любой
def toVector: Вектор[K]
- Definition Classes
- IterableOnceOps
def transpose[B](implicit asIterable: (K) => collection.Iterable[B]): Набор[Набор[B]]
Транспонирует это итерируемое множество итерируемых множеств в итерируемое множество итерируемых множеств.
Тип результирующего множества будет определяться статическим типом итерируемого множества. Например:
val xs = List(
Set(1, 2, 3),
Set(4, 5, 6)).transpose
// xs == List(
// List(1, 4),
// List(2, 5),
// List(3, 6))
val ys = Vector(
List(1, 2, 3),
List(4, 5, 6)).transpose
// ys == Vector(
// Vector(1, 4),
// Vector(2, 5),
// Vector(3, 6))
Примечание: Даже при применении к представлению или ленивому множеству элементы всегда будут принудительно вычисляться.
- B
тип элементов каждого итерируемого множества.
- asIterable
неявное преобразование, которое утверждает, что тип элементов этого итерируемого множества является
Iterable.- returns
двумерное итерируемое множество итерируемых множеств, у которого n-я строка является n-м столбцом этого итерируемого множества.
- Definition Classes
- IterableOps
- Исключения
IllegalArgumentException, если все множества в этом итерируемом множестве не имеют одинаковый размер.
final def union(that: collection.Set[K]): Набор[K]
Вычисляет объединение между множеством и другим множеством.
- that
множество, с которым формируется объединение.
- returns
новое множество, состоящее из всех элементов, которые присутствуют в этом множестве или в заданном множестве
that.
def unzip[A1, A2](implicit asPair: (K) => (A1, A2)): (Набор[A1], Набор[A2])
Преобразует это итерируемое множество пар в два множества первой и второй половины каждой пары.
val xs = Iterable(
(1, "one"),
(2, "two"),
(3, "three")).unzip
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three))
- A1
тип первой половины пар элементов
- A2
тип второй половины пар элементов
- asPair
неявное преобразование, которое утверждает, что тип элементов этого итерируемого множества является парой.
- returns
пара итерируемых множеств, содержащих первую, соответственно вторую половину каждой пары элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def unzip3[A1, A2, A3](implicit asTriple: (K) => (A1, A2, A3)): (Набор[A1], Набор[A2], Набор[A3])
Преобразует это итерируемое множество троек в три множества первого, второго и третьего элемента каждой тройки.
val xs = Iterable(
(1, "one", '1'),
(2, "two", '2'),
(3, "three", '3')).unzip3
// xs == (Iterable(1, 2, 3),
// Iterable(one, two, three),
// Iterable(1, 2, 3))
- A1
тип первого члена троек элементов
- A2
тип второго члена троек элементов
- A3
тип третьего члена троек элементов
- asTriple
неявное преобразование, которое утверждает, что тип элементов этого итерируемого множества является тройкой.
- returns
тройка итерируемых множеств, содержащих первый, второй, соответственно третий член каждой тройки элементов этого итерируемого множества.
- Definition Classes
- IterableOps
def view: Представление[K]
Представление элементов этого множества.
- Definition Classes
- IterableOps
final def wait(): Единица
- Definition Classes
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Долгое, arg1: Целое): Единица
- Definition Classes
- AnyRef
- Аннотации
- @throws(classOf[java.lang.InterruptedException])
final def wait(arg0: Long): Unit
def withFilter(p: (K) => Boolean): WithFilter[K, [_]Set[_]]
Создаёт нестрогий фильтр этой итерируемой коллекции.
Примечание: разница между c filter p и c withFilter p заключается в том, что первый создаёт новую коллекцию, тогда как второй только ограничивает область последующих map, flatMap, foreach, и withFilter операций.
Примечание: может возвращать разные результаты для разных запусков, если только базовый тип коллекции не упорядочен.
- p
предикат, используемый для проверки элементов.
- returns
объект класса
WithFilter, который поддерживаетmap,flatMap,foreach, иwithFilterоперации. Все эти операции применяются к тем элементам этой итерируемой коллекции, которые удовлетворяют предикатуp.
- Definition Classes
- IterableOps
def writeReplace(): AnyRef
- Attributes
- protected[this]
- Definition Classes
- DefaultSerializable
def zip[B](that: IterableOnce[B]): Set[(K, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов в пары. Если одна из двух коллекций длиннее другой, её оставшиеся элементы игнорируются.
- B
тип второй половины возвращаемых пар
- that
Итерируемый объект, предоставляющий вторую половину каждой результирующей пары
- returns
новая итерируемая коллекция, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции и
that. Длина возвращаемой коллекции равна минимуму длин этой итерируемой коллекции иthat.
- Definition Classes
- IterableOps
def zipAll[A1 >: K, B](that: collection.Iterable[B], thisElem: A1, thatElem: B): Set[(A1, B)]
Возвращает итерируемую коллекцию, образованную из этой итерируемой коллекции и другой итерируемой коллекции путём объединения соответствующих элементов в пары. Если одна из двух коллекций короче другой, для расширения более короткой коллекции до длины более длинной используются элементы-заполнители.
- that
итерируемый объект, предоставляющий вторую половину каждой результирующей пары
- thisElem
элемент, который будет использоваться для заполнения результата, если эта итерируемая коллекция короче, чем
that.- thatElem
элемент, который будет использоваться для заполнения результата, если
thatкороче, чем эта итерируемая коллекция.- returns
новая коллекция типа
That, содержащая пары, состоящие из соответствующих элементов этой итерируемой коллекции иthat. Длина возвращаемой коллекции равна максимуму длин этой итерируемой коллекции иthat. Если эта итерируемая коллекция короче, чемthat, значенияthisElemиспользуются для заполнения результата. Еслиthatкороче, чем эта итерируемая коллекция, значенияthatElemиспользуются для заполнения результата.
- Definition Classes
- IterableOps
def zipWithIndex: Set[(K, Int)]
Объединяет эту итерируемую коллекцию с её индексами.
- returns
Новая итерируемая коллекция, содержащая пары, состоящие из всех элементов этой итерируемой коллекции, объединённых с их индексами. Индексы начинаются с
0.
- Definition Classes
- IterableOps → IterableOnceOps
- Note
Повторное использование: после вызова этого метода следует отказаться от итератора, на котором он был вызван, и использовать только возвращённый итератор. Использование старого итератора не определено, может быть изменено и может привести к изменениям в новом итераторе.
List("a", "b", "c").zipWithIndex == List(("a", 0), ("b", 1), ("c", 2))
final def |(that: collection.Set[K]): Set[K]
Затенённые неявные члены значения
def +(other: String): String
- Неявный
- Этот член добавлен путём неявного преобразования из ImmutableKeySet вany2stringadd[ImmutableKeySet] с помощью метода any2stringadd в scala.Predef.
- Затенение
- Этот неявный унаследованный член затенён одним или несколькими членами в этом классе.
Для доступа к этому члену можно использовать приведение типа:(immutableKeySet: any2stringadd[ImmutableKeySet]).+(other)
- Определяющие классы
- any2stringadd
© 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/collection/immutable/MapOps$ImmutableKeySet.html
Класс-реализация множества, возвращаемого
keySet