====== IsetCount() ======

''IsetCount()''는 지정한 카운터의 현재값을 변경합니다.

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

''void IsetCount(uint8_t counter_id, int32_t value)''

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

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


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

<code cpp>
const uint8_t COUNTER_ID = 4;
const uint8_t PRESET_BUTTON_PIN = 0;
const int32_t PRESET_COUNT = 25;

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

void loop() {
  const bool presetButton = digitalRead(PRESET_BUTTON_PIN) == HIGH;
  static bool previousButton = false;

  if (presetButton && !previousButton) {
    IsetCount(COUNTER_ID, PRESET_COUNT);  // 지정한 카운터의 현재값을 변경합니다.
    Serial.println(F("counter preset to 25"));
  }
  previousButton = presetButton;
}
</code>

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

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

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

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

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