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...

PackedInt32Array

32 位整数紧缩数组。

描述

专门设计用于存放 32 位整数值的数组。数据是紧密存放的，因此能够在数组较大时节省内存。

注意：该类型存储的是 32 位有符号整数，也就是说它可以取区间 [-2^31, 2^31 - 1] 内的值，即 [-2147483648, 2147483647]。超过这些界限将环绕往复。相比之下，int 使用带符号的 64 位整数，可以容纳更大的值。如果你需要紧密存放 64 位整数，请参阅 PackedInt64Array。

备注

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

构造函数

PackedInt32Array	PackedInt32Array ( )
PackedInt32Array	PackedInt32Array ( PackedInt32Array from )
PackedInt32Array	PackedInt32Array ( Array from )

方法

bool	append ( int value )
void	append_array ( PackedInt32Array array )
int	bsearch ( int value, bool before=true )
void	clear ( )
int	count ( int value ) const
PackedInt32Array	duplicate ( )
void	fill ( int value )
int	find ( int value, int from=0 ) const
bool	has ( int value ) const
int	insert ( int at_index, int value )
bool	is_empty ( ) const
bool	push_back ( int value )
void	remove_at ( int index )
int	resize ( int new_size )
void	reverse ( )
int	rfind ( int value, int from=-1 ) const
void	set ( int index, int value )
int	size ( ) const
PackedInt32Array	slice ( int begin, int end=2147483647 ) const
void	sort ( )
PackedByteArray	to_byte_array ( ) const

操作符

bool	operator != ( PackedInt32Array right )
PackedInt32Array	operator + ( PackedInt32Array right )
bool	operator == ( PackedInt32Array right )
int	operator [] ( int index )

---

构造函数说明

PackedInt32Array PackedInt32Array ( )

构造空的 PackedInt32Array。

---

PackedInt32Array PackedInt32Array ( PackedInt32Array from )

构造给定 PackedInt32Array 的副本。

---

PackedInt32Array PackedInt32Array ( Array from )

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

---

方法说明

bool append ( int value )

向数组末尾追加一个元素（push_back 的别名）。

---

void append_array ( PackedInt32Array array )

在该数组的末尾追加一个 PackedInt32Array。

---

int bsearch ( int value, bool before=true )

使用二进法查找已有值的索引（如果该值尚未存在于数组中，则为保持排序顺序的插入索引）。传递 before 说明符是可选的。如果该参数为 false，则返回的索引位于数组中该值的所有已有的条目之后。

注意：在未排序的数组上调用 bsearch 会产生预料之外的行为。

---

void clear ( )

清空数组。相当于调用 resize 时指定大小为 0。

---

int count ( int value ) const

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

---

PackedInt32Array duplicate ( )

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

---

void fill ( int value )

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

---

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

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

---

bool has ( int value ) const

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

---

int insert ( int at_index, int value )

在数组中的给定位置插入新的整数。位置必须有效，或者位于数组末尾（idx == size()）。

---

bool is_empty ( ) const

该数组为空时，返回 true。

---

bool push_back ( int value )

将一个值添加到数组中。

---

void remove_at ( int index )

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

---

int resize ( int new_size )

设置数组的大小。如果数组被增大，则保留数组末端的元素。如果数组被缩小，则将数组截断到新的大小。

---

void reverse ( )

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

---

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

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

---

void set ( int index, int value )

更改给定索引处的整数。

---

int size ( ) const

返回数组中元素的个数。

---

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

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

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 ( )

将该数组中的元素按升序排列。

---

PackedByteArray to_byte_array ( ) const

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

新数组的大小为 int32_array.size() * 4。

---

操作符说明

bool operator != ( PackedInt32Array right )

如果数组内容不同，则返回 true。

---

PackedInt32Array operator + ( PackedInt32Array right )

返回新的 PackedInt32Array，新数组的内容为此数组在末尾加上 right。为了提高性能，请考虑改用 append_array。

---

bool operator == ( PackedInt32Array right )

如果两个数组的内容相同，即对应索引号的整数相等，则返回 true。

---

int operator [] ( int index )

返回索引 index 处的 int。负数索引可以从末尾开始访问元素。使用超出数组范围的索引会导致出错。

注意，int 类型为 64 位，与该数组中所存储的值不同。