PackedStringArray¶

String的打包数组。

描述¶

一个专门用于存储String的数组。它紧密地存储数据，因此可以节省大数组所需的内存。如果您想将数组中的字符串连接起来，请使用String.join()。

var string_array = PackedStringArray(["hello", "world"])
var string = " ".join(string_array)
print(string) # "hello world"

打包数组、类型化数组和无类型数组之间的区别：打包数组通常比同类型的类型化数组（例如PackedStringArray与Array[String]）更快地进行迭代和修改。此外，打包数组占用更少的内存。缺点是，打包数组的灵活性较低，因为它们不提供许多方便的方法，例如Array.map()。类型化数组则比无类型数组更快地进行迭代和修改。

注意：打包数组总是通过引用传递。如果要获得一个可以独立于原始数组进行修改的数组副本，请使用duplicate()。这不适用于内置属性和方法。这些返回的打包数组是副本，更改它们不会影响原始值。若要更新内置属性，需要修改返回的数组，然后再次将其分配给该属性。

构造函数¶

PackedStringArray	PackedStringArray()
PackedStringArray	PackedStringArray(from: PackedStringArray)
PackedStringArray	PackedStringArray(from: Array)

方法¶

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

运算符¶

bool	operator !=(right: PackedStringArray)
PackedStringArray	operator +(right: PackedStringArray)
bool	operator ==(right: PackedStringArray)
String	operator [](index: int)

构造函数说明¶

PackedStringArray PackedStringArray() 🔗

构造一个空的PackedStringArray。

PackedStringArray PackedStringArray(from: PackedStringArray)

构造一个PackedStringArray作为给定PackedStringArray的副本。

PackedStringArray PackedStringArray(from: Array)

构造一个新的PackedStringArray。或者，您可以传入一个将被转换的通用Array。

方法说明¶

bool append(value: String) 🔗

在数组的末尾附加一个元素（push_back()的别名）。

void append_array(array: PackedStringArray) 🔗

在此数组的末尾附加一个PackedStringArray。

int bsearch(value: String, before: bool = true) 🔗

使用二进制搜索查找现有值的索引（或保持排序顺序的插入索引，如果该值尚未出现在数组中）。可选地，可以传递before说明符。如果false，则返回的索引位于数组中该值的所有现有条目之后。

注意：在未排序的数组上调用bsearch()会导致意外行为。

void clear() 🔗

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

int count(value: String) const 🔗

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

PackedStringArray duplicate() 🔗

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

void fill(value: String) 🔗

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

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

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

String get(index: int) const 🔗

返回数组中给定index处的String。这与使用[]运算符（array[index]）相同。

bool has(value: String) const 🔗

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

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

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

bool is_empty() const 🔗

如果数组为空，则返回true。

bool push_back(value: String) 🔗

在数组末尾附加一个字符串元素。

void remove_at(index: int) 🔗

按索引从数组中删除元素。

int resize(new_size: int) 🔗

设置数组的大小。如果数组增长，则在数组末尾保留元素。如果数组缩小，则将数组截断为新大小。调用resize()一次并分配新值比逐个添加新元素更快。

void reverse() 🔗

反转数组中元素的顺序。

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

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

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

更改给定索引处的String。

int size() const 🔗

返回数组中元素的数量。

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

返回PackedStringArray的切片，从begin（包括）到end（不包括），作为新的PackedStringArray。

begin和end的绝对值将被钳制到数组大小，因此end的默认值使其默认切片到数组的大小（即arr.片段（1）是arr.片段（1， arr.size（））的简写）。

如果begin或end为负数，它们将相对于数组的末尾（即arr.片段（0，-2）是arr.片段（0， arr.size（）-2）的简写）。

void sort() 🔗

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

PackedByteArray to_byte_array() const 🔗

返回一个PackedByteArray，每个字符串编码为UTF-8。字符串被null终止。

运算符说明¶

bool operator !=(right: PackedStringArray) 🔗

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

PackedStringArray operator +(right: PackedStringArray) 🔗

返回一个新的PackedStringArray，在此数组末尾添加了right的内容。为了获得更好的性能，请考虑改用append_array()。

bool operator ==(right: PackedStringArray) 🔗

如果两个数组的内容相同，则返回true，即它们在相应的索引处都具有相等的Strings。

String operator [](index: int) 🔗

返回indexindex处的String。负索引可用于访问从末尾开始的元素。超出数组范围使用索引将导致错误。