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