使用此函数，您可以重新创建一个已保存的DS列表(以前使用ds_list_write()以字符串形式写入的DS列表)。您必须首先创建一个新的DS列表以读取字符串，如果DS列表已存在并且其中存储了信息，则在读取之前将清除此列表。为游戏创建保存/加载机制时，此函数至关重要。
请注意，如果指定的D字符串是GameMaker编写的：Studio 1.2. x运行时(或更早版本)，您应该指定可选参数"legacy"，将其设置为true，作为之后更改的字符串格式。
ds_list_read(id, str [, legacy]);
| 参数 | 类型 | 描述 |
|---|---|---|
| id | DS List | 要读入的数据结构的ID。 |
| str | String | 要从中读取的字符串。 |
| legacy | Boolean | 可选 可以为 true 或 false，也可以完全省略。 |
N/A
list = ds_list_create();
ini_open("save.ini");
var str = ini_read_string("Lists", "0", "");
if (str != "")
{
ds_list_read(list, str);
}
ini_close();
上述代码创建一个列表并将索引存储在变量"list"中。然后打开ini文件并从中读取字符串，检查以确保字符串不会首先返回为空。然后将此字符串读入新创建的ds_list。