isHexadecimalDigit() の解説と実装リファレンス

この記事の目次

【概要】
【仕様】
【技術的特徴】
【注意点】
【サンプルコード】
【活用例】

【概要】

isHexadecimalDigit() は、与えられた文字が16進数（Hexadecimal）の数字として有効であるかどうかを判定する論理関数です。この関数は、入力された文字が ‘0’ から ‘9’、および ‘a’ から ‘f’、または ‘A’ から ‘F’ のいずれかの範囲に含まれているかをチェックします。主にシリアル通信やユーザー入力を介した文字列の解析において、メモリ内の文字列が正しい16進数表現であるかを確認するバリデーション工程で使用されます。

【仕様】

引数:
- char c: 判定対象の1文字（ASCII文字として扱われる）。
戻り値:
- bool: 文字が16進数であれば true、それ以外（記号、空白、その他のアルファベット等）であれば false を返す。
データ型:
- 引数: char (8-bit signed/unsigned character)
- 戻り値: bool (boolean)
初期状態:
- 状態を保持しない純粋関数（Stateless function）。

【技術的特徴】

計算量: O(1)。条件分岐または比較演算のみで構成されるため、計算コストは極めて低い。
標準ライブラリとの比較: C言語標準の isxdigit() と実質的に同等の挙動をしますが、Arduino環境において移植性を保ちつつ、組み込み特有の制約下で直感的に利用できるように提供されています。
ハードウェアレベルの挙動: CPUの比較命令（CMP）を直接使用する実装が多く、フラグのチェックによって高速に判定が行われます。

【注意点】

文字エンコーディング: 本関数はASCII文字コードを前提としています。UTF-8や他のマルチバイト文字を含む環境では、期待通りの動作を保証しないため注意が必要です。
大文字・小文字の許容: この関数は ‘a’-‘f’ と ‘A’-‘F’ の両方を true と判定します。厳密に小文字のみを許可したい場合は、別途 isLower() 等の判定を組み合わせる必要があります。
NULL文字の扱い: NULL 文字（）や終端文字は false を返します。文字列の末尾判定と混同しないよう実装に注意してください。
リソース制約: 極めて軽量な関数であるため、メモリ制約の厳しいAVRやESP32などのマイコンにおいて、ループ内での多用によるオーバーヘッドは無視できるレベルです。

【サンプルコード】

#include <Arduino.h>

// シリアル入力から送られた文字列が正しい16進数か検証する関数
bool isValidHexString(const String& input) {
  for (int i = 0; i < input.length(); i++) {
    char c = input.charAt(i);
    // 16進数でない文字が含まれていればfalseを返す
    if (!isHexadecimalDigit(c)) {
      return false;
    }
  }
  return true;
}

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

void loop() {
  if (Serial.available() > 0) {
    String input = Serial.readStringUntil('\n');
    input.trim();

    if (isValidHexString(input)) {
      Serial.println("Valid Hex String");
    } else {
      Serial.println("Invalid Hex String detected");
    }
  }
}

【活用例】

通信プロトコルの解析: BLEやWi-Fi経由で送られてくるバイナリデータが、アスキー文字として送られてくる場合のバリデーション。
カラーコードの解析: RGB値を「#FF5733」のような形式で取得し、各文字が有効な16進数であることを保証してから parseInt() 等で数値化する処理。
メモリ番地の入力: ユーザーから特定のメモリアドレス（例：0x4000）を直接入力させるGUIやコマンドラインインターフェースの入力チェック。