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

take

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

take(array, n):T[]

پارامترها

arrayT[]الزامی

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

nnumberالزامی

تعداد عناصری که باید از ابتدای آرایه گرفته شوند.

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

T[]

یک آرایه جدید شامل n عنصر اول آرایه ورودی.

مثال‌ها

01

استفاده پایه

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

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

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

const result = take(numbers, 3);

console.log(result);
// [1, 2, 3]
02

گرفتن بیشتر از طول آرایه

اگر n بزرگ‌تر یا مساوی طول آرایه باشد، یک کپی از کل آرایه برگردانده می‌شود.

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

const numbers = [1, 2, 3];

const result = take(numbers, 10);

console.log(result);
// [1, 2, 3]
03

مقدار صفر یا منفی برای n

وقتی n صفر یا منفی باشد، تابع یک آرایه خالی برمی‌گرداند.

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

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

console.log(take(numbers, 0));
// []

console.log(take(numbers, -2));
// []
04

گرفتن تمام عناصر

وقتی n برابر با طول آرایه باشد، تمام عناصر در یک آرایه جدید برگردانده می‌شوند.

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

const numbers = [1, 2, 3];

const result = take(numbers, numbers.length);

console.log(result);
// [1, 2, 3]
05

آرایه خالی

گرفتن عناصر از یک آرایه خالی، یک آرایه خالی برمی‌گرداند.

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

const result = take([], 3);

console.log(result);
// []
ساخته شده با@cyref/js·مستندات رسمی