Chunk

Chunk<A> 表示类型为 A 的值的有序、不可变集合。虽然类似于数组，但 Chunk 提供了函数式接口，优化了某些在常规数组中可能代价高昂的操作，如重复连接。

仅在重复连接时使用 Chunk

Chunk 经过优化以管理重复数组连接的性能成本。对于不涉及重复连接的情况， 使用 Chunk 可能会引入不必要的开销，导致性能下降。

为什么使用 Chunk？

• 不可变性：与可变的标准 JavaScript 数组不同，Chunk 提供了真正的不可变集合，防止数据在创建后被修改。这在并发编程上下文中特别有用，不可变性可以增强数据一致性。

• 高性能：Chunk 支持高效数组操作的专门操作，如追加单个元素或连接块，使这些操作比其常规 JavaScript 数组等价物更快。

创建 Chunk

empty

使用 Chunk.empty 创建一个空的 Chunk。

示例（创建空 Chunk）

import { Chunk } from "effect"

//      ┌─── Chunk<number>
//      ▼
const chunk = Chunk.empty<number>()

make

要创建具有特定值的 Chunk，请使用 Chunk.make(...values)。请注意，结果块的类型为非空。

示例（创建非空 Chunk）

import { Chunk } from "effect"

//      ┌─── NonEmptyChunk<number>
//      ▼
const chunk = Chunk.make(1, 2, 3)

fromIterable

您可以通过提供集合来创建 Chunk，可以从可迭代对象或直接从数组创建。

示例（从可迭代对象创建 Chunk）

import { Chunk, List } from "effect"

const fromArray = Chunk.fromIterable([1, 2, 3])

const fromList = Chunk.fromIterable(List.make(1, 2, 3))

性能考虑

Chunk.fromIterable 创建可迭代对象元素的新副本。对于大型数据集或重复使用， 此克隆过程可能会影响性能。

unsafeFromArray

Chunk.unsafeFromArray 直接从数组创建 Chunk 而不进行克隆。这种方法可以通过避免复制数据的开销来提高性能，但需要谨慎，因为它绕过了通常的不可变性保证。

示例（直接从数组创建 Chunk）

import { Chunk } from "effect"

const chunk = Chunk.unsafeFromArray([1, 2, 3])

可变数据的风险

如果在创建块后修改原始数组，使用 Chunk.unsafeFromArray 可能导致意外行为。 为了更安全的不可变行为，请改用 Chunk.fromIterable。

连接

要将两个 Chunk 实例合并为一个，请使用 Chunk.appendAll。

示例（将两个 Chunks 合并为一个）

import { Chunk } from "effect"

// 连接两个具有不同类型元素的块
//
//      ┌─── NonEmptyChunk<string | number>
//      ▼
const chunk = Chunk.appendAll(Chunk.make(1, 2), Chunk.make("a", "b"))

console.log(chunk)
/*
输出:
{ _id: 'Chunk', values: [ 1, 2, 'a', 'b' ] }
*/

删除

要从 Chunk 的开头删除元素，请使用 Chunk.drop，指定要丢弃的元素数量。

示例（从开头删除元素）

import { Chunk } from "effect"

// 从 Chunk 中删除前 2 个元素
const chunk = Chunk.drop(Chunk.make(1, 2, 3, 4), 2)

比较

要检查两个 Chunk 实例是否相等，请使用 Equal.equals。此函数比较每个 Chunk 的内容以进行结构相等性比较。

示例（比较两个 Chunks）

import { Chunk, Equal } from "effect"

const chunk1 = Chunk.make(1, 2)
const chunk2 = Chunk.make(1, 2, 3)

console.log(Equal.equals(chunk1, chunk1))
// 输出: true

console.log(Equal.equals(chunk1, chunk2))
// 输出: false

console.log(Equal.equals(chunk1, Chunk.make(1, 2)))
// 输出: true

转换

使用 Chunk.toReadonlyArray 将 Chunk 转换为 ReadonlyArray。结果类型根据 Chunk 的内容而变化，区分空、非空和通用块。

示例（将 Chunk 转换为 ReadonlyArray）

import { Chunk } from "effect"

//      ┌─── readonly [number, ...number[]]
//      ▼
const nonEmptyArray = Chunk.toReadonlyArray(Chunk.make(1, 2, 3))

//      ┌─── readonly never[]
//      ▼
const emptyArray = Chunk.toReadonlyArray(Chunk.empty())

declare const chunk: Chunk.Chunk<number>

//      ┌─── readonly number[]
//      ▼
const array = Chunk.toReadonlyArray(chunk)