ds_list_size 함수 설명
ds_list_size
함수는 데이터 구조인 리스트의 "크기"를 반환합니다. 즉, 리스트에 추가된 항목의 수를 알려줍니다.
문법
ds_list_size(id);
매개변수
매개변수 | 타입 | 설명 |
---|---|---|
id | 데이터 구조 핸들 | 크기를 확인할 데이터 구조의 핸들 |
반환값
- 리스트에 추가된 항목의 수 (정수)
예제
if (!ds_list_empty(control_list)) {
num = ds_list_size(control_list);
}
위 코드는 control_list
라는 DS 리스트가 비어 있는지 확인하고, 비어 있지 않다면 리스트에 포함된 항목의 수를 가져와 num
변수에 저장합니다.
활용 예제
- 리스트의 크기 확인 후 항목 추가
if (ds_list_size(my_list) < 10) {
ds_list_add(my_list, new_item);
}
이 코드는 my_list
의 크기가 10보다 작을 경우에만 새로운 항목을 추가합니다.
- 리스트의 크기에 따라 다른 동작 수행
switch (ds_list_size(my_list)) {
case 0:
show_message("리스트가 비어 있습니다.");
break;
case 1:
show_message("리스트에 1개의 항목이 있습니다.");
break;
default:
show_message("리스트에 " + string(ds_list_size(my_list)) + "개의 항목이 있습니다.");
}
이 코드는 리스트의 크기에 따라 다른 메시지를 표시합니다.
- 리스트의 모든 항목 출력
for (var i = 0; i < ds_list_size(my_list); i++) {
var item = ds_list_find_value(my_list, i);
show_message("항목 " + string(i) + ": " + string(item));
}
이 코드는 리스트의 모든 항목을 순회하며 각 항목을 출력합니다.
- 리스트가 비어있지 않을 때만 작업 수행
if (!ds_list_empty(my_list)) {
var first_item = ds_list_find_value(my_list, 0);
// 첫 번째 항목으로 작업 수행
}
이 코드는 리스트가 비어있지 않을 때 첫 번째 항목을 가져와 작업을 수행합니다.