ds_list_replace 함수 설명
ds_list_replace
함수는 주어진 위치에 있는 값을 다른 값으로 교체하는 기능을 제공합니다. 만약 범위를 벗어난 위치에서 값을 교체하려고 하면 오류가 발생합니다. 예를 들어, ds_list_replace
를 사용할 때 범위를 벗어난 인덱스에 접근하려고 하면 오류가 발생합니다.
문법
ds_list_replace(id, pos, val);
매개변수 설명
매개변수 | 유형 | 설명 |
---|---|---|
id | DS List ID | 변경할 리스트의 핸들입니다. |
pos | Real | 값을 교체할 위치로, 0은 리스트의 시작을 의미하며, 마지막 위치는 ds_list_size(id)-1 입니다. |
val | Any | 주어진 값을 교체할 새로운 값입니다. |
반환값
- N/A
예제
ds_list_replace(n_list, 3, name);
위 코드는 리스트의 3번 위치에 저장된 값을 변수 "name"에 저장된 값으로 교체합니다.
활용 예제
- 리스트의 특정 위치에 값을 교체하는 기본 예제
var my_list = ds_list_create();
ds_list_add(my_list, "apple");
ds_list_add(my_list, "banana");
ds_list_add(my_list, "cherry");
ds_list_replace(my_list, 1, "orange"); // "banana"를 "orange"로 교체
- 사용자 입력을 통해 리스트의 값을 교체하는 예제
var user_input = "grape";
var index_to_replace = 0;
ds_list_replace(my_list, index_to_replace, user_input); // 첫 번째 값을 사용자 입력으로 교체
- 리스트의 마지막 값을 다른 값으로 교체하는 예제
var last_index = ds_list_size(my_list) - 1;
ds_list_replace(my_list, last_index, "kiwi"); // 마지막 값을 "kiwi"로 교체
- 범위를 벗어난 인덱스에 접근할 때의 예제
var invalid_index = 5;
ds_list_replace(my_list, invalid_index, "melon"); // 오류 발생: 범위를 벗어난 인덱스 접근
- 반복문을 사용하여 리스트의 모든 값을 교체하는 예제
for (var i = 0; i < ds_list_size(my_list); i++) {
ds_list_replace(my_list, i, "fruit_" + string(i)); // 모든 값을 "fruit_0", "fruit_1", ...로 교체
}