string_join_ext

此函数将给定数组(或数组的一部分)中所有值的字符串表示连接在一起,在每个值之间插入给定的"分隔符"。该函数返回联接的字符串。

不是字符串的值将具有隐式运行的 string() 函数。有关如何转换这些数据类型的信息,请参阅 从非字符串类型转换

 

语法:

string_join_ext(delimiter, values_array, [offset], [length]);

参数类型描述
delimiterString要在值之间插入的字符串
values_arrayArray包含要联接在一起的值的数组
offsetReal可选 数组中开始加入元素的偏移量或起始索引。设置负值将从数组的末尾开始计算。然后,起始索引将是 array_length(array) + offset。请参阅: 偏移量和长度
lengthReal可选 要连接的数组元素的数量,从偏移量开始。 负值将向后遍历数组(即按索引的降序,例如 2,1,0 而不是 2,3,4)。请参阅: 偏移量和长度

 

返回:

String

 

示例1:

var _words = string_join_ext(" ", ["This", "example", "joins", "words"]);

上面的代码使用空格作为分隔符,将数组中的单词连接到单个字符串中。

 

示例2:

var _buffer = buffer_create(1, buffer_grow, 1);
var _text_lines = ["This", "file", "will", "have", "multiple", "lines"];
var _file_contents = string_join_ext("\r\n", _text_lines);
buffer_write(_buffer, buffer_text, _file_contents);
buffer_save(_buffer, save_dir + "/" + "text.txt");
buffer_delete(_buffer);

上面的代码首先创建一个增长的 缓冲区 并将其赋给一个临时变量 _buffer。然后,它创建一个包含多个元素的数组,并将其存储在另一个变量 _text_lines 中。然后,它使用分隔符 "\r\n" 对数组调用 string_join_ext,这会在所有给定字符串之间产生新行。

它将生成的字符串作为 buffer_text 值写入缓冲区,然后将缓冲区内容保存到名为 "text.txt" 的文件中,该文件位于目录 save_dir 中。最后,它删除缓冲区以防止内存泄漏。