time_source_get_reps_remaining 함수 설명

time_source_get_reps_remaining 함수는 주어진 시간 소스가 완전히 멈출 때까지 남은 반복 횟수를 반환합니다. 이 함수는 주어진 시간 소스가 무한히 실행되거나 내장된 시간 소스인 경우 undefined를 반환합니다.

문법

time_source_get_reps_remaining(id);

인수

반환값

• Real: 남은 반복 횟수
• Back: 시간 소스
• Next: time_source_get_state

활용 예제

예제 1: 남은 반복 횟수 확인하기

var time_source_id = time_source_create(); // 시간 소스 생성
time_source_start(time_source_id, 5); // 5회 반복 시작
var remaining_reps = time_source_get_reps_remaining(time_source_id); // 남은 반복 횟수 가져오기
show_message("남은 반복 횟수: " + string(remaining_reps)); // 메시지로 출력

예제 2: 무한 반복 시간 소스 처리하기

var infinite_time_source_id = time_source_create(); // 무한 시간 소스 생성
time_source_start(infinite_time_source_id, -1); // 무한 반복 시작
var remaining_reps = time_source_get_reps_remaining(infinite_time_source_id); // 남은 반복 횟수 가져오기
if (remaining_reps == undefined) {
    show_message("이 시간 소스는 무한히 실행됩니다."); // 무한 실행 메시지
}

예제 3: 시간 소스 상태 확인하기

var time_source_id = time_source_create(); // 시간 소스 생성
time_source_start(time_source_id, 3); // 3회 반복 시작
while (time_source_get_reps_remaining(time_source_id) > 0) {
    // 반복 중 수행할 작업
}
show_message("모든 반복이 완료되었습니다."); // 완료 메시지

이와 같이 time_source_get_reps_remaining 함수를 활용하여 시간 소스의 남은 반복 횟수를 쉽게 확인하고, 다양한 상황에 맞게 사용할 수 있습니다.