ds_queue_head 함수 설명
ds_queue_head 함수는 큐의 첫 번째 값을 읽어오는 기능을 제공합니다. 이 함수는 큐에서 값을 제거하지 않기 때문에, 나중에 ds_queue_dequeue() 함수를 통해서도 해당 값을 읽을 수 있습니다. 만약 큐가 비어 있다면, 이 함수는 undefined라는 상수를 반환합니다. 그렇지 않으면 큐에 저장된 값을 반환합니다.
문법
ds_queue_head(id);
인수
| 인수 | 유형 | 설명 |
|---|---|---|
| id | DS Queue | 읽어올 데이터 구조의 핸들 |
반환값
| 반환값 | 설명 |
|---|---|
| Any | 큐에 저장된 데이터 타입의 값 |
예제
num = ds_queue_head(control_queue);
위 코드는 control_queue 변수에 인덱스된 큐의 첫 번째 값을 읽어와서, 반환된 값을 num 변수에 저장합니다.
활용 예제
예제 1: 큐의 첫 번째 값 출력
var first_value = ds_queue_head(my_queue);
show_message("큐의 첫 번째 값은: " + string(first_value));
예제 2: 큐가 비어 있는지 확인
if (ds_queue_head(my_queue) == undefined) {
show_message("큐가 비어 있습니다.");
} else {
var first_value = ds_queue_head(my_queue);
show_message("큐의 첫 번째 값은: " + string(first_value));
}
예제 3: 여러 번 첫 번째 값 읽기
var first_value1 = ds_queue_head(my_queue);
var first_value2 = ds_queue_head(my_queue);
show_message("첫 번째 값: " + string(first_value1) + ", 두 번째 값: " + string(first_value2));
예제 4: 큐에 값 추가 후 첫 번째 값 읽기
ds_queue_enqueue(my_queue, "첫 번째");
ds_queue_enqueue(my_queue, "두 번째");
var first_value = ds_queue_head(my_queue);
show_message("큐의 첫 번째 값은: " + string(first_value));
이 문서에서는 ds_queue_head 함수의 기본적인 사용법과 다양한 활용 예제를 소개했습니다.