====== IgetCount() ======

''IgetCount()''는 지정한 카운터의 현재값을 반환합니다.

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

''int32_t IgetCount(uint8_t counter_id)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IgetCount(counter_id)'' | ''uint8_t counter_id'' — 카운터 번호. ''uint8_t'' 범위이므로 ''0'' ~ ''255'' 사용 가능 | ''int32_t'' | 지정한 카운터의 현재값을 반환합니다. |


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

MPINO-8A4R(T)-S의 P0·P1 입력을 사용하는 예제입니다.

<code cpp>
const uint8_t COUNTER_ID = 3;
const int32_t BATCH_SIZE = 100;

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

void loop() {
  const bool itemSensor = digitalRead(0) == HIGH;
  const bool resetButton = digitalRead(1) == HIGH;
  Ictu(COUNTER_ID, itemSensor, resetButton, BATCH_SIZE);  // 입력의 상승 횟수를 세고 설정값에 도달하면 true를 반환합니다.

  const int32_t current = IgetCount(COUNTER_ID);  // 지정한 카운터의 현재값을 반환합니다.
  static int32_t previous = -1;
  if (current != previous) {
    previous = current;
    Serial.print(F("count="));
    Serial.println(current);
  }
}
</code>

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

  * 기존 0~31 고정 제한은 제거되었다. 단, 인수 타입이 ''uint8_t''이므로 최대 ID는 ''255''이다.
  * 메모리가 부족해서 카운터 상태를 확보하지 못하면 카운터 명령어는 ''false'' 또는 ''0''을 반환한다.
  * 한 번 생성된 카운터 상태는 프로그램 실행 중 유지된다.

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

  * [[commands:reference:ictu|Ictu() 상세 설명 보기]]
  * [[commands:reference:ictd|Ictd() 상세 설명 보기]]
  * [[commands:reference:ictud|Ictud() 상세 설명 보기]]
  * [[commands:reference:isetcount|IsetCount() 상세 설명 보기]]
  * [[commands:reference:ictuddownstate|IctudDownState() 상세 설명 보기]]

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