sequence_exists 함수 설명
sequence_exists 함수는 특정 시퀀스 객체가 존재하는지 확인하는 기능을 제공합니다. 이 함수는 시퀀스 객체 구조체(예: sequence_create() 또는 sequence_get() 함수로 반환된) 또는 시퀀스 ID(예: layer_sequence_get_sequence() 함수로 반환된, 또는 시퀀스 인스턴스 구조체의 sequence 속성에서 가져온, 또는 자산 브라우저의 인덱스)를 입력으로 받습니다. 함수는 시퀀스 객체가 존재하면 true를, 존재하지 않으면 false를 반환합니다.
문법
sequence_exists(sequence_struct_or_id);
인수 설명
| 인수 | 유형 | 설명 |
|---|---|---|
| sequence_struct_or_id | Sequence Asset 또는 Sequence Object Struct | 확인할 시퀀스. 자산 참조 자체 또는 그 시퀀스 객체 구조체일 수 있습니다. |
반환 값
- Boolean: 시퀀스 객체가 존재하면
true, 존재하지 않으면false.
예제
if (sequence_exists(my_seq)) {
sequence_destroy(my_seq);
}
위 코드는 주어진 시퀀스 객체가 존재하는지 확인하고, 존재할 경우 해당 객체를 파괴합니다.
활용 예제
- 시퀀스 생성 후 확인
var my_seq = sequence_create();
if (sequence_exists(my_seq)) {
// 시퀀스가 성공적으로 생성됨
}
- 시퀀스 ID로 확인
var seq_id = layer_sequence_get_sequence(my_layer);
if (sequence_exists(seq_id)) {
// 해당 레이어에 시퀀스가 존재함
}
- 시퀀스 삭제 전 확인
if (sequence_exists(my_seq)) {
sequence_destroy(my_seq);
} else {
// 시퀀스가 존재하지 않음
}
- 여러 시퀀스 확인
var seq_list = [seq1, seq2, seq3];
for (var i = 0; i < array_length(seq_list); i++) {
if (sequence_exists(seq_list[i])) {
// 시퀀스가 존재함
}
}
- 시퀀스 인스턴스 속성으로 확인
if (sequence_exists(instance.sequence)) {
// 인스턴스에 연결된 시퀀스가 존재함
}
이 문서에서는 sequence_exists 함수의 사용법과 다양한 활용 예제를 설명했습니다.