ForHosting KIT · 開発者向けツール

整数のビット長計算ツール

この整数ビット長計算ツールは、0 以上の整数を表すために必要な最小の2進桁数を求めます。10進整数を入力すると、正規化された値と正確なビット長が返されます。入力を文字列のまま保持してから厳密な整数演算を行うため、一般的な 32 ビットや 64 ビットの上限を大きく超える整数にも対応できます。保存領域の幅の選定、プロトコル境界の確認、2進表現の学習、サイズ前提の検証を、長い数値を手作業で変換せずに行えます。

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

無料で実行 API仕様を見る

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

整数のビット長が表すもの

正の整数のビット長は、位置を1から数えたときに最上位の 1 のビットがある位置です。先頭の 0 を除いた2進表記の桁数とも言えます。たとえば10進数の 13 は2進数で 1101 なので、ビット長は 4 です。8 から 15 まではすべて 4 ビットが必要ですが、16 は2の累乗の境界を越えるため 5 ビットが必要です。0 は例外で、1 のビットを持たないため、慣例上のビット長は 0 です。本ツールもこの定義を採用しています。結果は符号なしの大きさだけを示します。符号ビットの追加、2の補数表現、バイト境界への切り上げ、ファイル形式が要求するパディングは行いません。保存先や通信方式でアラインメント、符号、タグ、フレーム用のビットが必要な場合は、返された理論上の最小幅にそれらを加えてください。

計算の正確さを保つ仕組み

整数は、カンマ、空白、小数点、指数、プラス記号、マイナス記号を含まない10進数字として送信してください。入口で文字列として扱うことで、計算前の精度低下を防ぎます。多くのプログラミング環境では通常の数値を浮動小数点型で表すため、安全な範囲を超えるとすべての整数を区別できません。画面上では正しく見える値でも、ビット演算に渡る前に丸められていることがあります。本ツールは数字列全体を検証し、値に影響しない先頭の 0 を除去して、任意精度の厳密な整数へ変換します。その後、1 のビットがなくなるまで右シフトを繰り返し、その回数をビット長とします。この決定的な方式は、正確な2の累乗付近で起こり得る対数計算の丸めを避けられます。応答には正規化した10進整数も含まれるため、測定対象を確認できます。

技術設計での結果の使い方

ビット長は容量の境界を確認するときに特に役立ちます。結果が 8 なら符号なしの大きさは1バイトに収まり、9 ならバイト単位の保存では少なくとも2バイトが必要です。32 なら符号なし 32 ビットフィールドに収まりますが、33 は収まりません。データベース列、バイナリプロトコルのフィールド、シリアライズ、識別子の範囲、圧縮メタデータ、暗号テストベクトルなどの検討に利用できます。10進桁数から幅を推測せず、返された bit_length と格納先の容量を比較してください。符号付き形式では最上位ビットの扱いが異なるため、符号なしで収まっても符号付きで収まるとは限りません。バッチ処理やビルド時の検査では API を呼び出し、上限と照合できます。基本料金は $0.002 です。ネットワーク、乱数、時刻、可変状態を使わないため、同じ有効な整数からは常に同じ結果が得られます。

活用例

符号なし保存幅の選定

識別子やカウンターの最大値が、8、16、32、64 ビットまたは任意幅の符号なしフィールドに収まるか確認できます。

プロトコル境界の検証

テスト用の10進値を、バイナリプロトコルで割り当てられた固定数の大きさビットに符号化できるか確認できます。

任意精度値の調査

通常の浮動小数点数の安全範囲を超える整数でも、計算前に下位桁を失わずに必要な幅を測定できます。

よくある質問

0 のビット長はいくつですか？

0 には 1 のビットがないため、ビット長は 0 です。任意精度整数の API で一般的に使われる定義です。

先頭の 0 も数えますか？

いいえ。先頭の 0 は整数の値を変えないため、計算前に取り除かれます。応答には正規化後の値が返されます。

64 ビットを超える値も計算できますか？

はい。10進文字列として送信すれば、一般的なマシン語長を大きく超える整数も正確に計算できます。

結果に符号ビットは含まれますか？

いいえ。結果は符号なしの大きさに必要な最小幅です。符号付き形式や2の補数には、形式ごとの検討が必要です。

API の入力を文字列にする理由は何ですか？

10進文字列ならすべての桁を保持できます。数値型では、実行環境の安全な整数範囲を超えた時点ですでに丸められる場合があります。

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

API リクエスト1回の料金は $0.002 です。決定的でネットワークを必要としないため、ブラウザー上では無料でも実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/dev/bit-length-integer

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

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

curl -X POST https://api.kit.forhosting.com/dev/bit-length-integer \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integer":"18446744073709551615"}'

const res = await fetch("https://api.kit.forhosting.com/dev/bit-length-integer", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "integer": "18446744073709551615"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/bit-length-integer",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "integer": "18446744073709551615"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/bit-length-integer", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"integer":"18446744073709551615"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"integer":"18446744073709551615"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/bit-length-integer", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "integer": "18446744073709551615"
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.bit_length_integer",
  "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の完全なドキュメントを見る →