## 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配置文件。