CyrefJS
CCyrefJS
EN
بازگشت به مستندات
آرایه/از نسخه 1.38.0

chunk

یک آرایه را به چند آرایه کوچک‌تر با اندازه مشخص تقسیم می‌کند.

chunk(array, size):T[][]

پارامترها

arrayT[]الزامی

آرایه‌ای که باید به بخش‌های کوچک‌تر تقسیم شود.

sizenumberالزامی

حداکثر تعداد عناصر در هر بخش.

مقدار بازگشتی

T[][]

یک آرایه جدید شامل بخش‌های ایجادشده.

خطاها

اگر size کوچک‌تر یا مساوی صفر باشد، خطا ایجاد می‌کند.

مثال‌ها

01

استفاده پایه

یک آرایه را به بخش‌های سه‌تایی تقسیم می‌کند.

TypeScript
import { chunk } from "@cyref/js";

const numbers = [1, 2, 3, 4, 5, 6, 7];

const result = chunk(numbers, 3);

console.log(result);
// [[1, 2, 3], [4, 5, 6], [7]]
02

بخش آخر می‌تواند کوچک‌تر باشد

اگر طول آرایه به اندازه بخش تقسیم‌پذیر نباشد، بخش آخر شامل عناصر باقی‌مانده خواهد بود.

TypeScript
import { chunk } from "@cyref/js";

const numbers = [1, 2, 3, 4, 5, 6, 7];

const result = chunk(numbers, 3);

console.log(result);
// [[1, 2, 3], [4, 5, 6], [7]]
03

اندازه نامعتبر برای بخش

اگر اندازه بخش صفر یا منفی باشد، تابع خطا ایجاد می‌کند.

TypeScript
import { chunk } from "@cyref/js";

const numbers = [1, 2, 3, 4];

const result = chunk(numbers, 0);
// Error: Chunk size must be greater than 0
ساخته شده با@cyref/js·مستندات رسمی