Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
PackedFloat64Array
64 位浮点数紧缩数组。
描述
专门设计用于保存 64 位浮点值（双精度）的数组。紧密打包数据，因此可为大型数组节省内存。
如果只需要紧密打包 32 位浮点数，请参阅 PackedFloat32Array 以获得更节省内存的替代方案。
紧缩数组、类型化数组和非类型化数组之间的差异：与同类型的类型化数组相比，紧缩数组的迭代和修改速度通常更快（例如 PackedFloat64Array 与 Array[float]）。此外，紧缩数组消耗的内存更少。缺点是，紧缩数组不太灵活，因为它们不提供许多便捷方法，例如 Array.map()。类型化数组的迭代和修改速度反过来比非类型化数组更快。
注意：紧缩数组始终通过引用传递。要获取可以独立于原始数组进行修改的数组副本，请使用 duplicate()。内置属性和方法并非如此。这些返回的紧缩数组是副本，更改它不会影响原始值。要更新内置属性，需要修改返回的数组，然后再次将其分配给该属性。
Note
通过 C# 使用该 API 时会有显著不同，详见 C# API differences to GDScript。
构造函数
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)
构造给定 PackedFloat64Array 的副本。
PackedFloat64Array PackedFloat64Array(from: Array)
构造新 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() 🔗
创建该数组的副本，并将该副本返回。
将数组中的所有元素都设为给定的值。通常与 resize() 一起使用，创建给定大小的数组并初始化元素。
int find(value: float, from: int = 0) const 🔗
在数组中搜索值并返回其索引，如果未找到则返回 -1 。可选地，可以传递起始搜索索引。
注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。
返回数组中位于给定索引 index 处的 64 位浮点数。与使用 [] 运算符相同（array[index]）。
bool has(value: float) const 🔗
如果数组中包含 value，则返回 true。
注意：@GDScript.NAN 的行为与其他数字不同。因此，如果包含 NaN，则这个方法的结果可能不准确。
int insert(at_index: int, value: float) 🔗
在数组中给定的位置插入一个新元素。这个位置必须是有效的，或者是在数组的末端（idx == size()）。
该数组为空时，返回 true。
bool push_back(value: float) 🔗
在数组的末尾追加一个元素。
从数组中删除位于索引的元素。
设置数组的大小。如果数组被增大，则保留数组末端的元素。如果数组被缩小，则将数组截断到新的大小。调用一次 resize() 并分配新值比逐个添加新元素要快。
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 的切片，是从 begin（含）到 end（不含）的全新 PackedFloat64Array。
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 🔗
返回数据的副本，将其中的每个元素都编码为 8 个字节，放入 PackedByteArray 中。
新数组的大小为 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) 🔗
返回索引 index 处的 float。负数索引可以从末尾开始访问元素。使用超出数组范围的索引会导致出错。