## ds_list_read——加载字符串 #### **语法：** ```javascript ds_list_read(id, str [, legacy]); ``` 参数 | 描述 |---|---| id | 需要处理的列表索引值 str | 需要读取的字符串 legacy(可选)| 可以设置为true或false，也可以忽略不用该参数 #### **返回：** N/A #### **描述：** 使用这个方法你可以重新加载一个使用"ds_list_write"方法导出的字符串内容。这个方法在给游戏添加保存/读取功能时至关重要。要注意如果数据结构是用老版本的GameMaker生成的，你需要使用可选参数"legacy"来标记一下，因为这个版本中字符串的格式略有变动。 #### **示例：** ```javascript 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"的列表，然后打开了一个叫"save.ini"的ini配置文件，并从中获取了一段字符串内容存储到了一个叫"str"的变量中，然后判断"str"变量是否为空，如果不为空则将其中的内容读取到刚刚新建的"list"列表中，最后关闭那个ini配置文件。