ForHosting KIT · 開発者向けツール

ビットローテーション計算ツール｜左回転・右回転

このビットローテーション計算ツールは、固定幅の符号なし整数に対して左または右の循環回転を行います。一方の端から出たビットは直ちに反対側へ戻るため、シフトレジスタ、暗号プリミティブ、チェックサム、組み込みコード、低水準データ形式と同じ動作を確認できます。10進数、16進数、2進数の値を入力し、幅、方向、0以上の回転数を指定してください。先頭のゼロ位置を保ったまま、正確な10進数、固定幅2進数、桁埋め済み16進数を表示します。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

値とレジスタの正確な幅を指定します

ビット回転は幅が決まって初めて一意になります。同じ数値でも8ビットレジスタと16ビットレジスタでは折り返し位置が異なるため、結果も変わる場合があります。符号なしの値を通常の10進表記で入力するか、16進数には0x、2進数には0bを付けてください。続いて1から4096ビットの幅を選択します。値は指定幅に完全に収まる必要があります。大きすぎる値を拒否することで、暗黙の切り捨てによる情報損失を防ぎます。入力に書かれていなくても、先頭のゼロはレジスタの一部です。たとえば10進数の5を8ビットで扱う場合は101ではなく00000101です。返される2進数は常に指定幅まで埋められ、16進数もその幅を表せる完全な桁数まで補われます。そのため、レジスタ図、プロトコルフィールド、デバッガ表示、プログラム実装との比較が容易です。

左右の循環動作を理解します

循環回転は通常の論理シフトと異なり、ビットを捨てず、新しいゼロも挿入しません。左回転ではビットが上位端へ移動し、境界を越えたビットは下位位置へ戻ります。右回転では逆方向へ移動し、下位端から出たビットが上位端へ戻ります。本ツールは固定幅のパターン全体に対して、正確な整数演算を1回適用します。回転数が幅と等しい場合や幅の整数倍である場合、元のパターンに戻ります。そのため入力した回転数を幅で割った余りに正規化し、実際の回転数をnormalized_shiftとして返します。無制限の回転数を受け取るコードの確認や、各レジスタ位置の状態だけを必要とするハードウェアのモデル化に便利です。実効回転数が0なら、不正な全幅シフトを行わず、そのまま値を保持します。

出力を読み、実装を検証します

応答には、正規化した元の10進値、選択した幅、指定回転数、実効回転数、方向が含まれます。さらに回転後の値を10進数、固定幅2進数、大文字16進数で示します。2進数では折り返した各ビットを直接確認でき、16進数はレジスタや技術資料との照合に適し、10進数は接頭辞付きリテラルを避けるAPIやテストデータに便利です。実装を試す際は、両端付近に1があるパターンを使うと、誤った移動を見つけやすくなります。回転数0、幅と同じ値、幅より大きい値もお試しください。剰余処理や言語固有のシフト規則に関する典型的な不具合を検出できます。JavaScriptの32ビット演算子ではなく任意精度整数演算を使うため、32ビットを超えても符号変換や暗黙の回転数マスクは発生しません。処理は決定的かつローカルで、ネットワーク、乱数、時刻状態を使用しません。

活用例

組み込みレジスタの処理を確認

デバイスコードの作成やレビュー前に、ファームウェアの出力を正確な固定幅2進パターンと比較できます。

暗号処理の手順を検証

ハッシュ関数、暗号、混合処理の循環回転を、符号付き32ビット演算の影響なく確認できます。

プロトコルのテストベクトルを作成

指定幅内でビットが循環するフィールドについて、10進数・2進数・16進数の期待値を生成できます。

よくある質問

ビット回転とビットシフトは何が違いますか？

論理シフトは一方の端のビットを捨て、反対側にゼロを挿入します。回転は出たビットを反対側へ戻すため、固定幅パターンの全ビットが残ります。

回転数が幅を超えるとどうなりますか？

回転数を幅で割った余りへ正規化します。応答には指定した回転数と正規化後の実効回転数の両方が表示されます。

16進数や2進数を入力できますか？

はい。16進数には0x、2進数には0bを付けてください。接頭辞のない入力は10進数として解釈されます。

値が指定幅に収まる必要があるのはなぜですか？

自動的な切り捨ては上位ビットを気付かないまま削除し、誤解を招く結果を生む可能性があります。値または幅を明示的に修正できるよう、収まらない値は拒否します。

APIリクエストの料金はいくらですか？

APIリクエスト1回の料金は$0.002です。ブラウザ版では同じ決定的な計算をローカルで実行します。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/elec/rotate-bits

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/elec/rotate-bits \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":"150","width":8,"shift":3,"direction":"left"}'

const res = await fetch("https://api.kit.forhosting.com/elec/rotate-bits", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "value": "150",
    "width": 8,
    "shift": 3,
    "direction": "left"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/elec/rotate-bits",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "value": "150",
    "width": 8,
    "shift": 3,
    "direction": "left"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/elec/rotate-bits", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"value":"150","width":8,"shift":3,"direction":"left"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"value":"150","width":8,"shift":3,"direction":"left"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/elec/rotate-bits", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "value": "150",
  "width": 8,
  "shift": 3,
  "direction": "left"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "elec.rotate_bits",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →