====== IgetTime() ======

''IgetTime()''는 지정한 타이머의 현재 경과시간을 반환합니다.

{{:commands:reference:igettime.svg?900|IgetTime 명령어 동작 흐름}}

''unsigned long IgetTime(uint8_t timer_id)''

===== 명령어 =====

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IgetTime(timer_id)'' | ''uint8_t timer_id'' — 타이머 번호. ''0'' ~ ''255'' 범위에서 사용 가능 | ''unsigned long'' | 지정한 타이머의 현재 경과시간을 반환합니다. |


===== 예제 =====

MPINO-8A4R(T)-S 보드를 선택한 예제입니다. ''P0'' 입력과 ''P32'' 출력을 사용합니다. ''loop()''를 막지 않고 매번 명령어를 호출합니다. ''Iton(0, …)''이 갱신한 경과시간을 ''IgetTime(0)''으로 읽어 0.5초마다 표시합니다. 입력이 OFF이면 읽는 값은 0입니다.

<code cpp>
const uint8_t INPUT_PIN = 0;
unsigned long lastPrint = 0;

void setup() {
  Serial.begin(115200);
}

void loop() {
  const bool inputOn = digitalRead(INPUT_PIN) == HIGH;
  Iton(0, inputOn, 3000);  // 상태를 읽을 타이머를 매 loop에서 먼저 갱신합니다.
  const unsigned long elapsedMs = IgetTime(0);  // 같은 번호의 타이머가 측정한 경과시간을 ms로 읽습니다.
  if (millis() - lastPrint >= 500) {
    lastPrint = millis();
    Serial.println(elapsedMs);
  }
}
</code>

===== 주의사항 =====

  * 타이머 명령어는 ''loop()''에서 반복 호출해야 시간이 경과하고 입력 OFF도 반영됩니다.
  * 같은 ''timer_id''를 다른 타이머 동작과 공유하면 상태가 섞입니다. 동작마다 다른 번호를 사용하십시오.
  * 먼저 같은 번호의 타이머를 호출해야 합니다. 아직 생성되지 않은 번호를 읽으면 0을 반환합니다.

===== 같은 카테고리의 내장 명령어 =====

  * [[commands:reference:igetstate|IgetState() 상세 설명 보기]]

[[commands:builtin|← 내장 명령어 리스트]]