PackedFloat32Array

32 位浮点数紧缩数组。

描述

专门设计用于保存 32 位浮点值（float）的数组。紧密打包数据，因此可为大型数组节省内存。

如果需要紧密打包 64 位浮点数，请参阅 PackedFloat64Array。

注意：紧缩数组始终通过引用传递。要获取可以独立于原始数组进行修改的数组副本，请使用 duplicate。内置属性和方法并非如此。这些返回的紧缩数组是副本，更改它不会影响原始值。要更新内置属性，需要修改返回的数组，然后再次将其分配给该属性。

备注

通过 C# 使用该 API 时会有显著不同，详见 C# API 与 GDScript 的差异。

构造函数

方法

运算符

构造函数说明

PackedFloat32Array PackedFloat32Array() 🔗

构造空的 PackedFloat32Array。

PackedFloat32Array PackedFloat32Array(from: PackedFloat32Array)

构造给定 PackedFloat32Array 的副本。

PackedFloat32Array PackedFloat32Array(from: Array)

构造新 PackedFloat32Array。你还可以传入通用 Array 进行转换。

方法说明

bool append(value: float) 🔗

向数组末尾追加一个元素（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() 🔗

创建该数组的副本，并将该副本返回。

void fill(value: float) 🔗

将数组中的所有元素都设为给定的值。通常与 resize 一起使用，创建给定大小的数组并初始化元素。

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

在数组中搜索值并返回其索引，如果未找到则返回 -1 。可选地，可以传递起始搜索索引。

注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。

bool has(value: float) const 🔗

如果数组中包含 value，则返回 true。

注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。

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

在数组中给定的位置插入一个新元素。这个位置必须是有效的，或者是在数组的末端（idx == size()）。

bool is_empty() const 🔗

该数组为空时，返回 true。

bool push_back(value: float) 🔗

在数组的末尾追加一个元素。

void remove_at(index: int) 🔗

从数组中删除位于索引的元素。

int resize(new_size: int) 🔗

设置数组的大小。如果数组被增大，则保留数组末端的元素。如果数组被缩小，则将数组截断到新的大小。调用一次 resize 并分配新值比逐个添加新元素要快。

void reverse() 🔗

将数组中的元素逆序排列。

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

逆序搜索数组。还可以传递起始搜索位置索引。如果为负，则起始索引被视为相对于数组的结尾。

注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。

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

更改给定索引处的浮点数。

int size() const 🔗

返回数组中元素的个数。

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

返回该 PackedFloat32Array 的切片，是从 begin（含）到 end（不含）的全新 PackedFloat32Array。

begin 和 end 的绝对值会按数组大小进行限制，所以 end 的默认值会切到数组大小为止（即 arr.slice(1) 是 arr.slice(1, arr.size()) 的简写）。

如果 begin 或 end 为负，则表示相对于数组的末尾（即 arr.slice(0, -2) 是 arr.slice(0, arr.size() - 2) 的简写）。

void sort() 🔗

升序排列数组中的元素。

注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。

PackedByteArray to_byte_array() const 🔗

返回数据的副本，将其中的每个元素都编码为 4 个字节，放入 PackedByteArray 中。

新数组的大小为 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) 🔗

返回索引 index 处的 float。负的索引可用于访问从末尾开始的元素。使用超出数组范围的索引将产生一个错误。

请注意，float 类型是 64 位的，这与存储在数组中的值不同。