ds_list_clear

使用此函数,您可以清除给定列表数据结构中的所有数据。这不会破坏数据结构(对于应使用ds_list_destroy()的数据结构),它只会擦除其中的所有数据,并使列表为空(大小为零)。请注意,清除列表将取消引用存储在其中的任何数据结构,从而导致内存泄漏,因此您需要在清除列表之前手动浏览该列表并销毁所有数据结构项,以防止出现这种情况。唯一不需要执行此操作的时间是将列表中的任何项目标记为另一个DS列表DS映射时,在这种情况下,这些项目将被销毁(未清除!),并在清除父项时自动清除其内存。

 

语法:

ds_list_clear(id);

参数类型描述
idDS List要清除的数据结构的ID。

 

返回:

N/A

 

例子:

if (count == 15) && (!ds_list_empty(command_list))
{
    ds_list_clear(command_list);
    alarm[0] = game_get_speed(gamespeed_fps);
    ai_count = 0;
}

上述代码检查变量是否已达到特定值,以及是否清除变量"command_list"中索引的DS列表,设置报警,并将变量重置为0。