PackedFloat64Array
Упакований масив 64-розрядних значень точки плавлення.
Опис
Масив, спеціально розроблений для зберігання 64-бітних значень з плаваючою комою (double). Щільно упаковує дані, що економить пам'ять для масивів великого розміру.
Якщо вам потрібно щільно упаковувати лише 32-бітні числа з плаваючою комою, див. PackedFloat32Array для більш зручної для пам'яті альтернативи.
Відмінності між упакованими масивами, типізованими масивами та нетипізованими масивами: Упаковані масиви, як правило, швидше обробляються та модифікуються порівняно з типізованим масивом того ж типу (наприклад, PackedFloat64Array проти Array[float]). Крім того, упаковані масиви споживають менше пам'яті. Недоліком є те, що упаковані масиви менш гнучкі, оскільки вони не пропонують стільки зручних методів, таких як Array.map(). Типізовані масиви, у свою чергу, швидше обробляються та модифікуються, ніж нетипізовані масиви.
Примітка: Упаковані масиви завжди передаються за посиланням. Щоб отримати копію масиву, яку можна змінювати незалежно від оригінального масиву, використовуйте метод duplicate(). Це не стосується вбудованих властивостей і методів. У цих випадках повернутий упакований масив є копією, і його зміна не вплине на оригінальне значення. Щоб оновити вбудовану властивість цього типу, змініть повернутий масив, а потім знову призначте його властивості.
Примітка
Існують значні відмінності при використанні цього API із С#. Більше інформації: ref:doc_c_sharp_differences.
Конструктори
PackedFloat64Array(from: Array) |
Методи
void |
append_array(array: PackedFloat64Array) |
void |
clear() |
void |
|
is_empty() const |
|
void |
|
void |
reverse() |
void |
|
size() const |
|
void |
sort() |
to_byte_array() const |
Оператори
operator !=(right: PackedFloat64Array) |
|
operator +(right: PackedFloat64Array) |
|
operator ==(right: PackedFloat64Array) |
|
operator [](index: int) |
Описи конструкторів
PackedFloat64Array PackedFloat64Array() 🔗
Будуємо порожній PackedFloat64Array.
PackedFloat64Array PackedFloat64Array(from: PackedFloat64Array)
Constructs a PackedFloat64Array як копія даної PackedFloat64Array.
PackedFloat64Array PackedFloat64Array(from: Array)
Constructs a new PackedFloat64Array. Додатково ви можете пройти в загальній Array, яка буде перетворена.
Описи методів
Додає елемент у кінець масиву (псевдонім push_back()).
void append_array(array: PackedFloat64Array) 🔗
Додаток PackedFloat64Array в кінці цього масиву.
int bsearch(value: float, before: bool = true) 🔗
Знаходить індекс існуючого значення (або індекс вставки, який підтримує порядок сортування, якщо значення ще не присутнє в масиві) за допомогою бінарного пошуку. За бажанням можна передати специфікатор before. Якщо false, індекс, що повертається, йде після всіх існуючих записів значення в масиві.
Примітка: Виклик bsearch() на невідсортованому масиві призводить до неочікуваної поведінки.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
void clear() 🔗
Очищає масив. Еквівалентно використанню resize() з розміром 0.
int count(value: float) const 🔗
Повертає кількість разів елемент знаходиться в масиві.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
PackedFloat64Array duplicate() 🔗
Створює копію масиву і повертає його.
Видаляє перше входження значення з масиву та повертає true. Якщо значення не існує в масиві, нічого не відбувається, і повертається false. Щоб видалити елемент за індексом, використовуйте метод remove_at().
Примітка: @GDScript.NAN поводиться не так, як інші числа. Тому результати цього методу можуть бути неточними, якщо включені NaN.
Присвоює задане значення всім елементам масиву. Зазвичай це можна використовувати разом з resize() для створення масиву заданого розміру та ініціалізованих елементів.
int find(value: float, from: int = 0) const 🔗
Шукає значення в масиві та повертає індекс або -1, якщо не знайдено. Додатково може бути переданий початковий індекс пошуку.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
Повертає 64-бітне число з плаваючою комою за заданим index у масиві. Якщо index виходить за межі або є від'ємним, цей метод завершується невдачею та повертає 0.0.
Цей метод схожий (але не ідентичний) на оператор []. Найголовніше, що коли цей метод завершується невдачею, він не призупиняє виконання проекту, якщо його запускати з редактора.
bool has(value: float) const 🔗
Повертає true, якщо масив містить value.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
int insert(at_index: int, value: float) 🔗
Вставте новий елемент на даній позиції в масиві. Посада повинна бути дійсна, або в кінці масиву (idx == розмір()).
Повертає true, якщо масив порожній.
bool push_back(value: float) 🔗
Додаток елемента в кінці масиву.
Видаляє елемент з масиву за індексом.
Встановлює розмір масиву. Якщо масив збільшується, резервує елементи в кінці масиву. Якщо масив скорочується, обрізає масив до нового розміру. Виклик методу resize() один раз і призначення нових значень відбувається швидше, ніж додавання нових елементів по одному.
Повертає @GlobalScope.OK у разі успіху або одну з наступних констант Error, якщо цей метод не працює: @GlobalScope.ERR_INVALID_PARAMETER, якщо розмір від'ємний, або @GlobalScope.ERR_OUT_OF_MEMORY, якщо розподіл пам'яті не вдається. Використовуйте метод size(), щоб знайти фактичний розмір масиву після зміни розміру.
void reverse() 🔗
Змінює порядок елементів у масиві на протилежний.
int rfind(value: float, from: int = -1) const 🔗
Шукає значення в масиві у зворотному порядку. Додатково може бути переданий початковий індекс пошуку. Якщо негативний, початковий індекс вважається відносним до кінця масиву.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
void set(index: int, value: float) 🔗
Змінює число з рухомою комою в даній позиції.
Повертає кількість елементів у масиві.
PackedFloat64Array slice(begin: int, end: int = 2147483647) const 🔗
Повертає розріз PackedFloat64Array, з start (включно) до end (виключно), як новий PackedFloat64Array.
Абсолютне значення 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() 🔗
Сортує елементи масиву в порядку зростання.
Примітка: Поведінка @GDScript.NAN відрізняється від інших чисел. Через це результати цього методу можуть бути неточними за наявності NaN-ів.
PackedByteArray to_byte_array() const 🔗
Повертає копію даних, перетворених у PackedByteArray, де кожен елемент закодовано як 8 байтів.
Розмір нового масиву буде float64_array.size() * 8.
Описи операторів
bool operator !=(right: PackedFloat64Array) 🔗
Повертає true, якщо вміст масивів відрізняється.
PackedFloat64Array operator +(right: PackedFloat64Array) 🔗
Повертає новий PackedFloat64Array з вмістом right додано в кінці цього масиву. Для кращої роботи розглянемо використання append_array() замість.
bool operator ==(right: PackedFloat64Array) 🔗
Повертає true, якщо вміст обох масивів однаковий, тобто вони мають всі рівні подвійні коефіцієнти за відповідними показниками.
float operator [](index: int) 🔗
Повернення float в індекс index. Негативні індекси можуть використовуватися для доступу до елементів з кінця. Використання індексу з меж масиву призведе до помилки.