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
- Serializable
- AnyRef
- Any
- Hide All
- Show All
- Public
- All
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( ... ) @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[_]
- 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
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( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... ) @native()
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
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