DS 리스트 생성

이 문서는 DS 리스트를 생성하는 방법에 대해 설명합니다. DS 리스트는 데이터 구조의 일종으로, 여러 값을 저장할 수 있는 리스트입니다. 이 리스트를 생성하고 사용하는 방법을 알아보겠습니다.

함수 설명

ds_list_create 함수는 새로운 리스트 데이터 구조를 생성하고 그에 대한 핸들을 반환합니다. 이 핸들은 변수에 저장되어야 하며, 리스트와 관련된 모든 함수 호출에서 사용됩니다.

리스트가 생성된 후, 값이 추가되기 전까지는 리스트가 "비어있다"고 할 수 있습니다. 이 경우, 리스트의 첫 몇 개 항목은 성능 문제를 최소화하기 위해 내부적으로 0으로 설정됩니다. 따라서, ds_list_size 함수는 새로 생성된 리스트에 대해 0을 반환합니다. 리스트가 "진정으로" 비어있도록 하려면, 리스트를 생성한 후 ds_list_clear 함수를 호출해야 합니다. 이렇게 하면 비어있는 리스트 슬롯에 대한 반환 값이 정의되지 않게 됩니다.

문법

ds_list_create();

반환 값

• DS 리스트 핸들

예제

리스트를 생성하고 인스턴스 변수에 할당하는 예제입니다.

list = ds_list_create();

이 코드는 새로운 리스트를 생성하고 그 인덱스 ID를 인스턴스 변수 list에 할당합니다.

활용 예제

리스트를 생성하고 값을 추가하는 다양한 예제를 살펴보겠습니다.

예제 1: 리스트에 값 추가하기

list = ds_list_create();
ds_list_add(list, "첫 번째 값");
ds_list_add(list, "두 번째 값");

예제 2: 리스트에서 값 가져오기

value = ds_list_find_value(list, 0); // 첫 번째 값 가져오기

예제 3: 리스트 크기 확인하기

size = ds_list_size(list); // 리스트의 크기 확인

예제 4: 리스트 비우기

ds_list_clear(list); // 리스트 비우기

예제 5: 리스트 삭제하기

ds_list_destroy(list); // 리스트 삭제

표