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

shuffle

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

shuffle(array):T[]

پارامترها

arrayT[]الزامی

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

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

T[]

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

مثال‌ها

01

استفاده پایه

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

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

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

const result = shuffle(numbers);

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

آرایه اصلی بدون تغییر باقی می‌ماند

تابع قبل از shuffle کردن یک کپی ایجاد می‌کند، بنابراین آرایه اصلی تغییر نمی‌کند.

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

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

const result = shuffle(numbers);

console.log(numbers);
// [1, 2, 3, 4, 5]

console.log(result);
// Randomized order
03

با رشته‌ها

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

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

const languages = [
  "JavaScript",
  "TypeScript",
  "Python",
  "Go",
];

const result = shuffle(languages);

console.log(result);
// Example: ["Go", "JavaScript", "Python", "TypeScript"]
04

آرایه خالی

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

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

const result = shuffle([]);

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