리스트에 항목 삽입하기
이 문서에서는 리스트에 항목을 삽입하는 방법과 이와 관련된 유용한 정보를 설명합니다. 이 작업을 통해 지정된 리스트 내에서 항목의 인덱스 위치를 찾을 수 있습니다.
## 기본 개념
리스트에 값을 삽입하려면 다음 정보를 제공합니다:
- 리스트 인덱스를 저장할 변수 (이 변수는 `Create List` 작업에서 반환).
- 리스트 내에서 인덱스 위치를 찾고 싶은 값.
- 항목의 인덱스 위치를 저장할 대상 변수 (임시 지역 변수로 플래그를 설정할 수 있음).
리스트에 값을 삽입하면, 삽입할 인덱스 이상의 모든 인덱스가 하나씩 위로 이동합니다. 예를 들어, 4개의 항목이 있는 리스트 (인덱스 0부터 3)에서 인덱스 위치 2에 새 항목을 삽입하면, 이전 항목 2는 항목 3이 되고, 이전 항목 3은 항목 4가 됩니다.
만약 찾는 값이 리스트에 존재하지 않는다면, 반환되는 리스트 인덱스 위치는 -1이 됩니다.
## action 구문
```gml
// 예시 코드: 데이터 삽입을 위한 기본 구문
var myList = CreateList(); // 리스트 생성
var indexPosition; // 인덱스 위치를 저장할 변수
var newValue = 10; // 삽입할 새 값
// 값을 삽입
InsertIntoList(myList, 2, newValue, indexPosition);
매개변수 설명
| 매개변수 | 설명 |
|---|---|
| List | 삽입할 리스트의 인덱스(변수에 저장) |
| Index | 리스트 내에서 값을 삽입할 인덱스 위치 |
| Value | 해당 위치에 저장할 값 |
예제
다음은 리스트에 랜덤 값을 삽입하는 예제입니다.
var myList = CreateList(); // 리스트 생성
var size = GetListItemCount(myList); // 리스트의 크기 얻기
var randomPosition = irandom(size); // 리스트 내 랜덤 인덱스 생성
var randomValue = irandom(100); // 0부터 100까지의 랜덤 값 생성
// 랜덤 위치에 값을 삽입
InsertIntoList(myList, randomPosition, randomValue);
추가 활용 및 응용
- 정렬된 리스트에 삽입하기: 리스트를 정렬된 상태로 유지하려면 각 항목을 삽입할 때 적절한 인덱스 위치를 찾아서 위치에 맞게 삽입하세요.
- 중복된 항목 제거: 리스트에 값을 삽입하기 전에 해당 값이 리스트에 존재하는지 확인하세요. 존재할 경우 삽입을 하지 않도록 합니다.
- 리스트 내용 재구성: 삽입 작업 후 리스트의 모든 항목을 순회하면서 필요한 조작을 추가적으로 수행할 수 있습니다.
리스트에 항목을 삽입하는 것은 데이터를 관리하는 데 매우 유용합니다. 충분한 연습을 통해 이 기능을 잘 활용해 보세요! ```