مرجع آرایه‌ها

آرایه فهرست مرتبی از مقدارهای یک نوع است. بسیاری از توابع این صفحه به شکل متد نوشته می‌شوند: a.push(x) همان array.push(a, x) است.

توابع#

array.abs#

array.abs([array])

آرایهٔ تازه‌ای با قدر مطلق هر عنصر.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
• خروجی: یک آرایه.

array.all#

array.all([array])

وقتی آرایه خالی نباشد و همهٔ عنصرها true باشند true است.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: true یا false.

array.any#

array.any([array])

وقتی دست‌کم یک عنصر true باشد true است.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: true یا false.

array.at#

array.at(array, index)

عنصری که در یک اندیس است.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: خواندن محافظت‌شده، خواندن بیرون از انتهای آرایه.

array.avg#

array.avg([array])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.binary_search#

array.binary_search([array], [value])

اندیس یک مقدار در یک آرایهٔ مرتب‌شده، یا -1 وقتی آن مقدار در آرایه نیست.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد صحیح.

array.binary_search_leftmost#

array.binary_search_leftmost([array], [value])

اندیس اولین عنصرِ برابر با مقدار در یک آرایهٔ مرتب‌شده؛ وقتی هیچ عنصری برابر نباشد، اندیس عنصری که درست پایینِ جای آن مقدار قرار می‌گیرد.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد صحیح.

array.binary_search_rightmost#

array.binary_search_rightmost([array], [value])

اندیس آخرین عنصرِ برابر با مقدار در یک آرایهٔ مرتب‌شده؛ وقتی هیچ عنصری برابر نباشد، اندیس عنصری که درست بالایِ جای آن مقدار قرار می‌گیرد.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد صحیح.

array.clear#

array.clear(array)

همهٔ عنصرها را حذف می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.concat#

array.concat([array], [other])

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

• اثر: یک مجموعه را درجا تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
• خروجی: همان آرایه.

array.contains#

array.contains([array], [value])

وقتی آرایه آن مقدار را داشته باشد true است.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.copy#

array.copy([array])

یک کپی از آرایه.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.covariance#

array.covariance([array], [other], [biased])

کوواریانس دو آرایهٔ هم‌اندازه؛ جفت‌هایی که na دارند کنار گذاشته می‌شوند، و biased به جای «تعداد منهای یک» بر خودِ تعداد تقسیم می‌کند.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد.

array.fill#

array.fill([array], [value], [from], [to])

عنصرها را از اندیس from تا to (خودِ to نه) برابر یک مقدار می‌کند؛ بدون بازه، کل آرایه را پر می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.first#

array.first([array])

اولین یا آخرین عنصر.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.index_of#

array.index_of([array], [value])

اندیس اولین یا آخرین عنصرِ برابر با مقدار، یا -1.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.insert#

array.insert([array], [index], [value])

مقداری را در یک اندیس درج می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.join#

array.join([array], [separator])

عنصرها به شکل یک متن، با separator در میانشان.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.last#

array.last([array])

اولین یا آخرین عنصر.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: خواندن محافظت‌شده، خواندن بیرون از انتهای آرایه.

array.last_index_of#

array.last_index_of([array], [value])

اندیس اولین یا آخرین عنصرِ برابر با مقدار، یا -1.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.max#

array.max([array], [nth])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: باند میانهٔ غلتان، خواندن آرایه با کروشه.

array.median#

array.median([array])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: باند میانهٔ غلتان.

array.min#

array.min([array], [nth])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: باند میانهٔ غلتان، خواندن آرایه با کروشه.

array.mode#

array.mode([array])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.new#

array.new([size], [initial])

آرایه‌ای با size عنصر می‌سازد که هر کدام initial است.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.percent_rank#

array.percent_rank([array], [index])

درصد عنصرهایی که کوچک‌تر یا مساوی عنصرِ اندیس index هستند.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: عددی از 0 تا 100.

array.percentile#

array.percentile([array], [percent])

مقدارِ یک درصدِ معین از عنصرهای مرتب‌شده، با درون‌یابی بین دو رتبهٔ نزدیک‌تر.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد.
• مثال‌ها: باند میانهٔ غلتان، خواندن آرایه با کروشه.

array.percentile_nearest#

array.percentile_nearest([array], [percent])

مقدارِ یک درصدِ معین از عنصرهای مرتب‌شده، برداشته‌شده از نزدیک‌ترین رتبه.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• خروجی: یک عدد.

array.pop#

array.pop(array)

آخرین عنصر را برمی‌دارد و برمی‌گرداند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.push#

array.push(array, value)

مقداری را به انتها اضافه می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
• مثال‌ها: باند میانهٔ غلتان، مسیر سقف‌های سوئینگ، خواندن محافظت‌شده، خواندن آرایه با کروشه.

array.range#

array.range([array])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.remove#

array.remove(array, index)

عنصرِ یک اندیس را برمی‌دارد و برمی‌گرداند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.reverse#

array.reverse([array])

ترتیب را درجا وارونه می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.set#

array.set(array, index, value)

عنصرِ یک اندیس را تعیین می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.shift#

array.shift([array])

اولین عنصر را برمی‌دارد و برمی‌گرداند.

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: باند میانهٔ غلتان، مسیر سقف‌های سوئینگ، خواندن آرایه با کروشه.

array.size#

array.size(array)

تعداد عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.
• مثال‌ها: باند میانهٔ غلتان، مسیر سقف‌های سوئینگ، خواندن محافظت‌شده، خواندن آرایه با کروشه.

array.slice#

array.slice([array], [from], [to])

یک کپی از بخشی از آرایه.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.sort#

array.sort([array], [order])

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

• اثر: یک مجموعه را درجا تغییر می‌دهد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.sort_indices#

array.sort_indices([array], [order])

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

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
• خروجی: آرایه‌ای از عددهای صحیح.

array.standardize#

array.standardize([array])

آرایهٔ تازه‌ای که در آن هر عنصر به z-score تبدیل شده است: فاصله‌اش از میانگین بر حسب انحراف معیار.

• اثر: مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.
• خروجی: آرایه‌ای از عددها.

array.stdev#

array.stdev([array], [biased])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.sum#

array.sum([array])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.

array.unshift#

array.unshift([array], [value])

مقداری را به ابتدا اضافه می‌کند.

• اثر: یک مجموعه را درجا تغییر می‌دهد؛ مقدار تازه‌ای می‌سازد که اندازه‌اش تابع آرگومان‌هاست (در دفتر حافظه شمرده می‌شود).
• مرحله: روی هر کندل.
• هزینه: حافظه می‌گیرد: دفتر حافظه آنچه را می‌سازد می‌شمارد.

array.variance#

array.variance([array], [biased])

یک آمارهٔ عنصرها.

• اثر: ندارد: نتیجه فقط به آرگومان‌ها بستگی دارد.
• مرحله: روی هر کندل.
• هزینه: تعداد ثابتی عملیات.