PackedFloat32Array

32位浮点值的打包数组。

描述

专门设计用于保存32位浮点值(浮点数)的数组。紧密打包数据,因此它可以为大数组大小节省内存。

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

注意:打包数组总是通过引用传递的。要获得可以独立于原始数组进行修改的数组的副本,请使用duplicate()。内置属性和方法的情况是而不是。这些返回的打包数组是副本,更改它将而不是影响原始值。要更新内置属性,您需要修改返回的数组,然后再次将其分配给属性。

构造函数

方法

bool

append(value: float)

void

append_array(array: PackedFloat32Array)

int

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

void

clear()

int

count(value: float) const

PackedFloat32Array

duplicate()

void

fill(value: float)

int

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

float

get(index: int) const

bool

has(value: float) const

int

insert(at_index: int, value: float)

bool

is_empty() const

bool

push_back(value: float)

void

remove_at(index: int)

int

resize(new_size: int)

void

reverse()

int

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

void

set(index: int, value: float)

int

size() const

PackedFloat32Array

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

void

sort()

PackedByteArray

to_byte_array() const

运算符


构造函数说明

PackedFloat32Array PackedFloat32Array() 🔗

构造一个空的PackedFloat32Array


PackedFloat32Array PackedFloat32Array(from: PackedFloat32Array)

构造一个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()会导致意外行为。

注意:@S3Script.NAN的行为与其他数字不同。因此,如果包含NaN,此方法的结果可能不准确。


void clear() 🔗

清除数组。这相当于使用大小为0resize()


int count(value: float) const 🔗

返回元素在数组中的次数。

注意:@S3Script.NAN的行为与其他数字不同。因此,如果包含NaN,此方法的结果可能不准确。


PackedFloat32Array duplicate() 🔗

创建数组的副本,并返回它。


void fill(value: float) 🔗

将给定值分配给数组中的所有元素。这通常可以与resize()一起使用,以创建具有给定大小和初始化元素的数组。


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

在数组中搜索一个值,如果未找到,则返回其索引或-1。可选地,可以传递初始搜索索引。

注意:@S3Script.NAN的行为与其他数字不同。因此,如果包含NaN,此方法的结果可能不准确。


float get(index: int) const 🔗

返回数组中给定index处的32位浮点数。这与使用[]运算符(array[index])相同。


bool has(value: float) const 🔗

如果数组包含value,则返回true

注意:@S3Script.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 🔗

以相反的顺序搜索数组。或者,可以传递开始搜索索引。如果为负,则认为开始索引相对于数组的末尾。

注意:@S3Script.NAN的行为与其他数字不同。因此,如果包含NaN,此方法的结果可能不准确。


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

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


int size() const 🔗

返回数组中元素的数量。


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

返回PackedFloat32Array的切片,从begin(包括)到end(不包括),作为新的PackedFloat32Array

beginend的绝对值将被钳制到数组大小,因此end的默认值使其默认切片到数组的大小(即arr.片段(1)arr.片段(1, arr.size())的简写)。

如果beginend为负数,它们将相对于数组的末尾(即arr.片段(0,-2)arr.片段(0, arr.size()-2)的简写)。


void sort() 🔗

按升序对数组的元素进行排序。

注意:@S3Script.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) 🔗

返回indexindex处的float。负索引可用于访问从末尾开始的元素。在数组边界之外使用索引将导致错误。

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