PackedInt64Array

Упакований масив 64-бітних цілих чисел.

Опис

Масив, спеціально розроблений для зберігання 64-бітних цілочисельних значень. Щільно упаковує дані, що економить пам'ять для масивів великого розміру.

Примітка: Цей тип зберігає знакові 64-бітні цілі числа, що означає, що він може приймати значення в інтервалі [-2^63, 2^63 - 1], тобто [-9223372036854775808, 9223372036854775807]. Перевищення цих меж призведе до перекидання. Якщо вам потрібно щільно упаковувати лише 32-бітні цілі числа, див. PackedInt32Array для більш зручної для пам'яті альтернативи.

Відмінності між упакованими масивами, типізованими масивами та нетипізованими масивами: Упаковані масиви, як правило, швидше перебираються та модифікуються порівняно з типізованим масивом того ж типу (наприклад, PackedInt64Array проти Array[int]). Також упаковані масиви споживають менше пам'яті. Недоліком є те, що упаковані масиви менш гнучкі, оскільки вони не пропонують стільки зручних методів, як Array.map(). Типізовані масиви, у свою чергу, швидше перебираються та модифікуються, ніж нетипізовані масиви.

Примітка: Упаковані масиви завжди передаються за посиланням. Щоб отримати копію масиву, яку можна модифікувати незалежно від оригінального масиву, використовуйте duplicate(). Це не стосується вбудованих властивостей та методів. У цих випадках повернений упакований масив є копією, і його зміна не вплине на оригінальне значення. Щоб оновити вбудовану властивість цього типу, змініть повернутий масив, а потім знову призначте його властивості.

Примітка

Існують значні відмінності при використанні цього API із С#. Більше інформації: ref:doc_c_sharp_differences.

Конструктори

PackedInt64Array

PackedInt64Array()

PackedInt64Array

PackedInt64Array(from: PackedInt64Array)

PackedInt64Array

PackedInt64Array(from: Array)

Методи

bool

append(value: int)

void

append_array(array: PackedInt64Array)

int

bsearch(value: int, before: bool = true)

void

clear()

int

count(value: int) const

PackedInt64Array

duplicate()

bool

erase(value: int)

void

fill(value: int)

int

find(value: int, from: int = 0) const

int

get(index: int) const

bool

has(value: int) const

int

insert(at_index: int, value: int)

bool

is_empty() const

bool

push_back(value: int)

void

remove_at(index: int)

int

resize(new_size: int)

void

reverse()

int

rfind(value: int, from: int = -1) const

void

set(index: int, value: int)

int

size() const

PackedInt64Array

slice(begin: int, end: int = 2147483647) const

void

sort()

PackedByteArray

to_byte_array() const

Оператори

bool

operator !=(right: PackedInt64Array)

PackedInt64Array

operator +(right: PackedInt64Array)

bool

operator ==(right: PackedInt64Array)

int

operator [](index: int)

Описи конструкторів

PackedInt64Array PackedInt64Array() 🔗

Будуємо порожній PackedInt64Array.

PackedInt64Array PackedInt64Array(from: PackedInt64Array)

Constructs a PackedInt64Array як копія даної PackedInt64Array.

PackedInt64Array PackedInt64Array(from: Array)

Constructs a new PackedInt64Array. Додатково ви можете пройти в загальній Array, яка буде перетворена.

Описи методів

bool append(value: int) 🔗

Додає елемент у кінець масиву (псевдонім push_back()).

void append_array(array: PackedInt64Array) 🔗

Додаток PackedInt64Array в кінці цього масиву.

int bsearch(value: int, before: bool = true) 🔗

Знаходить індекс існуючого значення (або індекс вставки, який підтримує порядок сортування, якщо значення ще не присутнє в масиві) за допомогою бінарного пошуку. За бажанням можна передати специфікатор before. Якщо false, індекс, що повертається, йде після всіх існуючих записів значення в масиві.

Примітка: Виклик bsearch() на невідсортованому масиві призводить до неочікуваної поведінки.

void clear() 🔗

Очищає масив. Еквівалентно використанню resize() з розміром 0.

int count(value: int) const 🔗

Повертає кількість повторень елемента в масиві.

PackedInt64Array duplicate() 🔗

Створює копію масиву і повертає його.

bool erase(value: int) 🔗

Видаляє перше входження значення з масиву та повертає true. Якщо значення не існує в масиві, нічого не відбувається, і повертається false. Щоб видалити елемент за індексом, використовуйте метод remove_at().

void fill(value: int) 🔗

Присвоює задане значення всім елементам масиву. Зазвичай це можна використовувати разом з resize() для створення масиву заданого розміру та ініціалізованих елементів.

int find(value: int, from: int = 0) const 🔗

Шукає в масиві значення і повертає його індекс або -1, якщо таке не знайдено. За бажанням можна передати початковий індекс пошуку.

int get(index: int) const 🔗

Повертає 64-бітове ціле число за заданим index у масиві. Якщо index виходить за межі або є від'ємним, цей метод завершується невдачею та повертає 0.

Цей метод схожий (але не ідентичний) на оператор []. Найголовніше, що коли цей метод завершується невдачею, він не призупиняє виконання проекту, якщо його запускати з редактора.

bool has(value: int) const 🔗

Повертає true, якщо масив містить value.

int insert(at_index: int, value: int) 🔗

Вставте нове ціле місце в даній позиції в масиві. Посада повинна бути дійсна, або в кінці масиву (idx == розмір()).

bool is_empty() const 🔗

Повертає true, якщо масив порожній.

bool push_back(value: int) 🔗

Додає значення до масиву.

void remove_at(index: int) 🔗

Видаляє елемент з масиву за індексом.

int resize(new_size: int) 🔗

Встановлює розмір масиву. Якщо масив збільшується, резервує елементи в кінці масиву. Якщо масив скорочується, обрізає масив до нового розміру. Виклик методу resize() один раз і призначення нових значень відбувається швидше, ніж додавання нових елементів по одному.

Повертає @GlobalScope.OK у разі успіху або одну з наступних констант Error, якщо цей метод не працює: @GlobalScope.ERR_INVALID_PARAMETER, якщо розмір від'ємний, або @GlobalScope.ERR_OUT_OF_MEMORY, якщо розподіл пам'яті не вдається. Використовуйте метод size(), щоб знайти фактичний розмір масиву після зміни розміру.

void reverse() 🔗

Змінює порядок елементів у масиві на протилежний.

int rfind(value: int, from: int = -1) const 🔗

Здійснює пошук у масиві у зворотному порядку. За бажанням можна передати початковий індекс пошуку. Якщо він від'ємний, то початковий індекс береться відносно кінця масиву.

void set(index: int, value: int) 🔗

Змінює ціле в даній позиції.

int size() const 🔗

Повертає кількість елементів у масиві.

PackedInt64Array slice(begin: int, end: int = 2147483647) const 🔗

Повертає розріз PackedInt64Array, з start (включно) до end (виключно), як новий PackedInt64Array.

Абсолютне значення start і end буде зафіксовано до розміру масиву, тому значення за замовчуванням для end робить кінець розрізу кінцем масиву за замовчуванням (тобто arr.slice(1) є скороченим записом для arr.slice(1, arr.size())).

Якщо ж start або end є негативними, вони будуть відносно кінця масиву (тобто arr.slice(0, -2) є скороченим записом для arr.slice(0, arr.size() - 2)).

void sort() 🔗

Сорти елементів масиву в порядку закріплення.

PackedByteArray to_byte_array() const 🔗

Повертає копію даних, перетворених у PackedByteArray, де кожен елемент закодовано як 8 байтів.

Розмір нового масиву буде int64_array.size() * 8.

Описи операторів

bool operator !=(right: PackedInt64Array) 🔗

Повертає true, якщо вміст масивів відрізняється.

PackedInt64Array operator +(right: PackedInt64Array) 🔗

Повертає новий PackedInt64Array з вмістом right додано в кінці цього масиву. Для кращої роботи розглянемо використання append_array() замість.

bool operator ==(right: PackedInt64Array) 🔗

Повертаємо true, якщо вміст обох масивів однаковий, тобто вони мають всі рівні показники за відповідними показниками.

int operator [](index: int) 🔗

Повертаємо int в індексі index. Негативні індекси можуть використовуватися для доступу до елементів з кінця. Використання індексу з меж масиву призведе до помилки.