crc16file

2024/09/04 13:40 Macro::TTL コマンドリファレンス
【Tera Term マクロ言語】コマンドリファレンス

crc16file 機能

[その他のコマンド]

CRC-16-IBM を計算します。

コマンドライン

crc16 <intvar> <file name>

機能説明

引数のファイルから CRC (Cyclic Redundancy Checking) を計算します。
多項式（右回り）は以下のとおりです。

0xA001 (x^{16}+x^{15}+x^{2}+x0)

計算結果は <intvar> に数値として格納されます。
crc16file でファイルが開けなかった場合は、システム変数 <result> に -1 が格納されます。

CRC アルゴリズムの実装（C言語）を以下に示します。
static unsigned int crc16(int n, unsigned char c[])
{
#define CRC16POLY2  0x8408U  /* 左右逆転 */

	int i, j;
	unsigned long r;

	r = 0xFFFFU;
	for (i = 0; i < n; i++) {
		r ^= c[i];
		for (j = 0; j < CHAR_BIT; j++)
			if (r & 1) r = (r >> 1) ^ CRC16POLY2;
			else       r >>= 1;
	}
	return r ^ 0xFFFFU;
}

パラメータの説明

指定するパラメータは以下の通りです。
パラメータ型パラメータ説明
<intvar>文字列計算結果を格納する変数を指定します。
<file name>整数対象ファイルを指定します。

対象バージョン

バージョン 4.78 以降で利用可能です。

戻り値

戻り値として以下の変数が定義されます。
変数名値意味
result-1対象ファイルが開けなかった
0対象ファイルが開けた
<intvar>文字列CRC-16-IBM の計算結果
<intvar> は、コマンド実行時に指定した任意の文字列です。

関連コマンド

種別：その他Ver機能の簡易説明
crc164.78以降CRC-16-IBMを計算する。
crc324.60以降CRC-32を計算する。
crc32file4.60以降CRC-32を計算する。

使用方法

使用例

・crc16file を計算する場合
crc16file crc 'foo.bin'
if result = -1 then
    messagebox 'file open error' 'CRC16 = '
else
    sprintf '0x%08X' crc
    messagebox inputstr 'CRC16 = '
endif

サンプル

サンプルマクロはありません。

備考

特にありません。