====== IdigitalRead() ======

''IdigitalRead()''는 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.

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

''bool IdigitalRead(uint8_t pin, uint8_t samples)''

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

^ 명령어 ^ 인수 ^ 반환값 ^ 동작 ^
| ''IdigitalRead(pin, samples)'' | ''uint8_t pin'' — 디지털 입력 핀 번호\\ ''uint8_t samples'' — 연속 읽기 횟수. ''1'' 이하는 1회 읽기, 최대 ''255''회까지 적용 | ''bool'' | 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다. |

===== 동작 방식 =====

  * ''samples''회 연속으로 입력을 읽습니다.
  * 모든 읽기값이 ''HIGH''이면 안정 상태를 ''HIGH''로 갱신합니다.
  * 모든 읽기값이 ''LOW''이면 안정 상태를 ''LOW''로 갱신합니다.
  * ''HIGH''와 ''LOW''가 섞이면 짧은 노이즈가 포함된 것으로 보고 이전 안정 상태를 유지합니다.
  * 이전 안정 상태가 아직 없고 읽기값이 섞이면 ''LOW''를 반환합니다.


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

MPAINO-8A8R(T)의 입력 ''0''을 읽고 출력 ''64''에 결과를 표시하는 예제입니다.

<code cpp>
void setup() {}

void loop() {
  bool input = IdigitalRead(0, 5);  // 입력을 여러 번 연속으로 읽고, 모든 값이 같을 때만 상태를 갱신합니다. HIGH와 LOW가 섞이면 이전 안정 상태를 유지합니다.

  if (input) {
    digitalWrite(64, HIGH);
  } else {
    digitalWrite(64, LOW);
  }
}
</code>

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

  * ''samples''가 ''1'' 이하이면 입력을 한 번만 읽습니다.
  * ''samples''를 크게 설정할수록 한 번 호출하는 시간이 길어집니다. 일반적인 입력 노이즈 확인에는 ''3''회 또는 ''5''회를 권장합니다.
  * 이 명령어는 여러 번 즉시 읽는 방식입니다. 기계식 스위치처럼 ms 단위 채터링을 제거하려면 ''Ibounce()''를 사용하십시오.

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

  * [[commands:ibounce|Ibounce() 상세 설명 보기]]
  * [[commands:reference:ibounceon|IbounceOn() 상세 설명 보기]]
  * [[commands:reference:ibounceoff|IbounceOff() 상세 설명 보기]]

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