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

zip

دو آرایه را عنصر به عنصر بر اساس index با یکدیگر جفت می‌کند و زمانی که آرایه کوتاه‌تر تمام شود، متوقف می‌شود.

zip(array1, array2):[T, U][]

پارامترها

array1T[]الزامی

آرایه اول که عناصر آن با عناصر آرایه دوم جفت می‌شوند.

array2U[]الزامی

آرایه دوم که عناصر آن با عناصر آرایه اول جفت می‌شوند.

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

[T, U][]

یک آرایه جدید شامل جفت‌های متناظر از عناصر هر دو آرایه. طول نتیجه برابر با طول آرایه کوتاه‌تر است.

مثال‌ها

01

استفاده پایه

دو آرایه را عنصر به عنصر با یکدیگر جفت می‌کند.

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

const numbers = [1, 2, 3];
const letters = ["a", "b", "c"];

const result = zip(numbers, letters);

console.log(result);
// [[1, "a"], [2, "b"], [3, "c"]]
02

آرایه‌هایی با طول متفاوت

اگر طول دو آرایه متفاوت باشد، zip زمانی متوقف می‌شود که آرایه کوتاه‌تر تمام شود.

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

const numbers = [1, 2, 3, 4];
const letters = ["a", "b"];

const result = zip(numbers, letters);

console.log(result);
// [[1, "a"], [2, "b"]]
03

انواع متفاوت

دو آرایه می‌توانند شامل مقادیر با typeهای متفاوت باشند.

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

const names = ["Alice", "Bob", "Charlie"];
const ages = [25, 30, 35];

const result = zip(names, ages);

console.log(result);
// [["Alice", 25], ["Bob", 30], ["Charlie", 35]]
04

آرایه‌های خالی

اگر هر کدام از آرایه‌های ورودی خالی باشد، نتیجه یک آرایه خالی خواهد بود.

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

const numbers = [1, 2, 3];
const letters: string[] = [];

const result = zip(numbers, letters);

console.log(result);
// []
05

اشیاء

تابع zip می‌تواند آرایه‌های شامل objectها و مقادیر primitive را نیز با یکدیگر جفت کند.

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

const users = [
  { id: 1, name: "Alice" },
  { id: 2, name: "Bob" },
];

const roles = ["admin", "user"];

const result = zip(users, roles);

console.log(result);
// [
//   [{ id: 1, name: "Alice" }, "admin"],
//   [{ id: 2, name: "Bob" }, "user"],
// ]
ساخته شده با@cyref/js·مستندات رسمی