abstract class Chunk[+O] extends Serializable with ChunkPlatform[O]
Strict, finite sequence of values that allows index-based random access of elements.
Chunk
s can be created from a variety of collection types using methods on the Chunk
companion
(e.g., Chunk.vector
, Chunk.seq
, Chunk.array
). Additionally, the Chunk
companion
defines a subtype of Chunk
for each primitive type, using an unboxed primitive array.
To work with unboxed arrays, use methods like toBytes
to convert a Chunk[Byte]
to a Chunk.Bytes
and then access the array directly.
The operations on Chunk
are all defined strictly. For example, c.map(f).map(g).map(h)
results in
intermediate chunks being created (1 per call to map
).
- Self Type
- Chunk[O]
- Source
- Chunk.scala
- Alphabetic
- By Inheritance
- Chunk
- ChunkPlatform
- Serializable
- AnyRef
- Any
- Hide All
- Show All
- Public
- Protected
Instance Constructors
- new Chunk()
Abstract Value Members
- abstract def apply(i: Int): O
Returns the element at the specified index.
Returns the element at the specified index. Throws if index is < 0 or >= size.
- abstract def copyToArray[O2 >: O](xs: Array[O2], start: Int = 0): Unit
Copies the elements of this chunk in to the specified array at the specified start index.
- abstract def size: Int
Returns the number of elements in this chunk.
- abstract def splitAtChunk_(n: Int): (Chunk[O], Chunk[O])
Splits this chunk in to two chunks at the specified index
n
, which is guaranteed to be in-bounds.Splits this chunk in to two chunks at the specified index
n
, which is guaranteed to be in-bounds.- Attributes
- protected
Concrete Value Members
- final def !=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def ##: Int
- Definition Classes
- AnyRef → Any
- final def ==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
- final def asInstanceOf[T0]: T0
- Definition Classes
- Any
- def clone(): AnyRef
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.CloneNotSupportedException]) @native() @HotSpotIntrinsicCandidate()
- def collect[O2](pf: PartialFunction[O, O2]): Chunk[O2]
More efficient version of
filter(pf.isDefinedAt).map(pf)
. - def drop(n: Int): Chunk[O]
Drops the first
n
elements of this chunk. - final def eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- def equals(a: Any): Boolean
- Definition Classes
- Chunk → AnyRef → Any
- def filter(p: (O) => Boolean): Chunk[O]
Returns a chunk that has only the elements that satisfy the supplied predicate.
- def find(p: (O) => Boolean): Option[O]
Returns the first element for which the predicate returns true or
None
if no elements satisfy the predicate. - def flatMap[O2](f: (O) => Chunk[O2]): Chunk[O2]
Maps
f
over the elements of this chunk and concatenates the result. - def foldLeft[A](init: A)(f: (A, O) => A): A
Left-folds the elements of this chunk.
- def forall(p: (O) => Boolean): Boolean
Returns true if the predicate passes for all elements.
- def foreach(f: (O) => Unit): Unit
Invokes the supplied function for each element of this chunk.
- final def getClass(): Class[_ <: AnyRef]
- Definition Classes
- AnyRef → Any
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- def hashCode(): Int
- Definition Classes
- Chunk → AnyRef → Any
- def head: Option[O]
Gets the first element of this chunk.
- def indexWhere(p: (O) => Boolean): Option[Int]
Returns the index of the first element which passes the specified predicate (i.e.,
p(i) == true
) orNone
if no elements pass the predicate. - final def isEmpty: Boolean
True if size is zero, false otherwise.
- final def isInstanceOf[T0]: Boolean
- Definition Classes
- Any
- def iterator: Iterator[O]
Creates an iterator that iterates the elements of this chunk.
Creates an iterator that iterates the elements of this chunk. The returned iterator is not thread safe.
- def knownElementType[B](implicit classTag: ClassTag[B]): Boolean
Returns true if this chunk is known to have elements of type
B
.Returns true if this chunk is known to have elements of type
B
. This is determined by checking if the chunk type mixes inChunk.KnownElementType
. - def last: Option[O]
Gets the last element of this chunk.
- def map[O2](f: (O) => O2): Chunk[O2]
Creates a new chunk by applying
f
to each element in this chunk. - def mapAccumulate[S, O2](init: S)(f: (S, O) => (S, O2)): (S, Chunk[O2])
Maps the supplied stateful function over each element, outputting the final state and the accumulated outputs.
Maps the supplied stateful function over each element, outputting the final state and the accumulated outputs. The first invocation of
f
usesinit
as the input state value. Each successive invocation uses the output state of the previous invocation. - final def ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
- final def nonEmpty: Boolean
False if size is zero, true otherwise.
- final def notify(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- final def notifyAll(): Unit
- Definition Classes
- AnyRef
- Annotations
- @native() @HotSpotIntrinsicCandidate()
- def reverseIterator: Iterator[O]
Creates an iterator that iterates the elements of this chunk in reverse order.
Creates an iterator that iterates the elements of this chunk in reverse order. The returned iterator is not thread safe.
- def scanLeft[O2](z: O2)(f: (O2, O) => O2): Chunk[O2]
Like
foldLeft
but emits each intermediate result off
. - def scanLeftCarry[O2](z: O2)(f: (O2, O) => O2): (Chunk[O2], O2)
Like
scanLeft
except the final element is emitted as a standalone value instead of as the last element of the accumulated chunk.Like
scanLeft
except the final element is emitted as a standalone value instead of as the last element of the accumulated chunk.Equivalent to
val b = a.scanLeft(z)(f); val (c, carry) = b.splitAt(b.size - 1)
. - def scanLeft_[O2](z: O2, emitZero: Boolean)(f: (O2, O) => O2): (Chunk[O2], O2)
- Attributes
- protected
- def splitAt(n: Int): (Chunk[O], Chunk[O])
Splits this chunk in to two chunks at the specified index.
- final def synchronized[T0](arg0: => T0): T0
- Definition Classes
- AnyRef
- def take(n: Int): Chunk[O]
Takes the first
n
elements of this chunk. - def toArray[O2 >: O](implicit arg0: ClassTag[O2]): Array[O2]
Copies the elements of this chunk to an array.
- def toArraySeq[O2 >: O](implicit arg0: ClassTag[O2]): ArraySeq[O2]
- Definition Classes
- ChunkPlatform
- def toArraySeqUntagged: ArraySeq[O]
- Definition Classes
- ChunkPlatform
- def toBitVector[B >: O](implicit ev: =:=[B, Byte]): BitVector
Converts this chunk to a scodec-bits BitVector.
- def toBooleans[B >: O](implicit ev: =:=[B, Boolean]): Booleans
Converts this chunk to a
Chunk.Booleans
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Booleans
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of booleans, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toByteBuffer[B >: O](implicit ev: =:=[B, Byte]): ByteBuffer
Converts this chunk to a
java.nio.ByteBuffer
. - def toByteVector[B >: O](implicit ev: =:=[B, Byte]): ByteVector
Converts this chunk to a scodec-bits ByteVector.
- def toBytes[B >: O](implicit ev: =:=[B, Byte]): Bytes
Converts this chunk to a
Chunk.Bytes
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Bytes
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of bytes, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toChain: Chain[O]
Converts this chunk to a chain.
- def toDoubles[B >: O](implicit ev: =:=[B, Double]): Doubles
Converts this chunk to a
Chunk.Doubles
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Doubles
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of doubles, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toFloats[B >: O](implicit ev: =:=[B, Float]): Floats
Converts this chunk to a
Chunk.Floats
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Floats
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of doubles, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toInts[B >: O](implicit ev: =:=[B, Int]): Ints
Converts this chunk to a
Chunk.Ints
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Ints
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of bytes, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toList: List[O]
Converts this chunk to a list.
- def toLongs[B >: O](implicit ev: =:=[B, Long]): Longs
Converts this chunk to a
Chunk.Longs
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Longs
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of longs, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toNel: Option[NonEmptyList[O]]
Converts this chunk to a NonEmptyList
- def toShorts[B >: O](implicit ev: =:=[B, Short]): Shorts
Converts this chunk to a
Chunk.Shorts
, allowing access to the underlying array of elements.Converts this chunk to a
Chunk.Shorts
, allowing access to the underlying array of elements. If this chunk is already backed by an unboxed array of bytes, this method runs in constant time. Otherwise, this method will copy of the elements of this chunk in to a single array. - def toString(): String
- Definition Classes
- Chunk → AnyRef → Any
- def toVector: Vector[O]
Converts this chunk to a vector.
- final def wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- final def wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException]) @native()
- final def wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.InterruptedException])
- def zip[O2](that: Chunk[O2]): Chunk[(O, O2)]
Zips this chunk the the supplied chunk, returning a chunk of tuples.
- def zipWith[O2, O3](that: Chunk[O2])(f: (O, O2) => O3): Chunk[O3]
Zips this chunk with the supplied chunk, passing each pair to
f
, resulting in an output chunk. - def zipWithIndex: Chunk[(O, Int)]
Zips the elements of the input chunk with its indices, and returns the new chunk.
Zips the elements of the input chunk with its indices, and returns the new chunk.
scala> Chunk("The", "quick", "brown", "fox").zipWithIndex.toList res0: List[(String, Int)] = List((The,0), (quick,1), (brown,2), (fox,3))
Example:
Deprecated Value Members
- def finalize(): Unit
- Attributes
- protected[lang]
- Definition Classes
- AnyRef
- Annotations
- @throws(classOf[java.lang.Throwable]) @Deprecated
- Deprecated