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

''IgetCount()''は指定したカウンタの現在値を返します。

{{:ja-jp_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''を返します。
  * 一度作成したカウンタ状態はプログラム実行中保持されます。

===== 同じカテゴリの内蔵コマンド =====

  * [[:ja-jp_commands:reference:ictu|Ictu() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:ictd|Ictd() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:ictud|Ictud() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:isetcount|IsetCount() 詳細説明を見る]]
  * [[:ja-jp_commands:reference:ictuddownstate|IctudDownState() 詳細説明を見る]]

[[:ja-jp_commands:builtin|← 内蔵コマンド一覧]]