行優先配列のインデックス・オフセット計算
8バイトの要素を3×4×5に並べた配列では、位置1、2、3の通し番号は33、オフセットは264バイト、基準4096からのアドレスは4360です。途中の値がすべて見えるので、ポインタ計算の確認やバッファの調査に使えます。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 次元
- 3, 4, 5
- インデックス
- 1, 2, 3
- 要素サイズ(バイト)
- 8
- 基底アドレス
- 4,096
- 順序
- row-major
- ストライド
- 20, 5, 1
- 拠出額
- 20, 10, 3
- 線形インデックス
- 33
この計算ツールは、多次元配列の座標を、C方式の連続した行優先メモリ配置で使われる一意の線形位置へ変換します。外側から内側の順に各次元、各軸に対応するゼロ始まりの添字、要素のバイト数、必要に応じて基準アドレスをご入力ください。各軸のストライド、添字ごとの寄与、要素オフセット、バイトオフセット、最終バイトアドレスを個別に表示するため、ポインター演算やフラット化したバッファーを確認できます。
次元と添字を同じ軸順で入力します
次元の大きさは、宣言やshapeに記載されているとおり、最も外側の軸から最も内側の軸へ並べます。3平面、4行、5列の配列であれば、3、4、5と入力します。続いて、各次元に1つずつ、同じ順序でゼロ始まりの添字を指定します。
2番目の平面、3番目の行、4番目の列を表す座標は1、2、3です。次元は正の整数でなければならず、各添字は0以上かつ対応する次元未満である必要があります。ランクが一致しない入力や範囲外の座標は拒否されるため、配列外のアドレスが気付かないまま生成されることはありません。
要素インデックスだけではバイト位置を決められないため、要素サイズも必須です。一般的な32ビット整数なら4バイト、doubleなら8バイトのように、実際の格納幅をご指定ください。配列の開始位置が分かる場合は0以上の基準アドレスを入力し、不明な場合は既定値の0のままにして、結果を先頭からの相対オフセットとしてお読みください。
行優先のストライド計算を確認します
行優先では最後の軸が連続して格納されるため、その軸を1つ進むと正確に1要素進み、ストライドは1になります。それより前の各軸のストライドは、右側にある全次元の積です。次元が3×4×5ならストライドは20、5、1です。
平面を1つ進むと5要素の行を4つ飛ばし、行を1つ進むと5要素、列を1つ進むと1要素移動します。本ツールは各添字に対応軸のストライドを掛け、その積を寄与として表示します。寄与の合計がゼロ始まりの線形インデックスです。
座標1、2、3では、1×20に2×5と3×1を加え、33になります。途中の値を確認できるため、次元の逆転や列優先の乗数を使う典型的な誤りを見つけやすくなります。演算はすべて安全な整数として検査され、積や和がJavaScriptの安全整数範囲を超える場合は、丸めたアドレスではなく入力エラーを返します。
要素インデックスをバイトアドレスへ変換します
線形インデックスが数えるのは要素であり、バイトではありません。バイトオフセットを求めるには、線形インデックスに要素サイズを掛けます。インデックス33で各要素が8バイトなら、その要素は配列先頭から264バイト後に始まります。
最終バイトアドレスは、そのオフセットを指定した基準アドレスへ加えた値です。基準が4096なら開始アドレスは4360です。応答では線形インデックス、バイトオフセット、基準アドレス、最終アドレスを分けて示すため、ソースコード、デバッガー、バイナリ形式の仕様、GPUバッファー計算などと各段階を照合できます。
安全整数範囲内の正確な10進整数を返すだけで、実際のメモリ参照や実行中プロセスの検査は行いません。要素間や行間にパディングのない、密で連続した配列を前提とします。pitch付きの行、明示的なleading dimension、スライスされたview、独自ストライドには、実際の物理ストライドをご使用ください。
活用例
ポインター演算を検証
C、C++、Rust、WebAssemblyでフラット化したバッファーへアクセスする前に、要素とバイトのオフセットを確認します。
テンソルのフラット化を調査
想定する行優先ストライドと寄与を、テンソルライブラリ、シリアライザー、データ交換処理と比較します。
メモリ配置を説明
多次元座標の各値が連続した位置と最終アドレスへどのように寄与するかを示します。
よくある質問
添字はゼロ始まりですか?
はい。 各添字は0から始まり、対応する次元の大きさ未満でなければなりません。
行優先とは何ですか?
標準的なCの多次元配列と同様に、連続メモリ上で最後の軸が最も速く変化する配置です。
基準アドレスには何を指定しますか?
配列が始まるバイトアドレスをご指定ください。先頭からの相対オフセットだけが必要なら0のままで構いません。
列優先配列にも対応しますか?
いいえ。 本計算は行優先専用です。列優先の格納方式では異なるストライド列を使用します。
行のパディングや独自ストライドも扱えますか?
いいえ。 密で連続した要素を前提とします。pitch、パディング、転置、スライスには実際の物理ストライドが必要です。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/dev/array-rowmajor-index \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"dimensions":[3,4,5],"indices":[1,2,3],"element_size_bytes":8}'const res = await fetch("https://api.kit.forhosting.com/dev/array-rowmajor-index", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"dimensions": [
3,
4,
5
],
"indices": [
1,
2,
3
],
"element_size_bytes": 8
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/array-rowmajor-index",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"dimensions": [
3,
4,
5
],
"indices": [
1,
2,
3
],
"element_size_bytes": 8
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/array-rowmajor-index", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"dimensions":[3,4,5],"indices":[1,2,3],"element_size_bytes":8}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"dimensions":[3,4,5],"indices":[1,2,3],"element_size_bytes":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/array-rowmajor-index", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"dimensions": [
3,
4,
5
],
"indices": [
1,
2,
3
],
"element_size_bytes": 8
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.array_rowmajor_index",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
制限
max_dimensions | 32 |
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
要素インデックスをバイトアドレスへ変換します
APIの各リクエストは$0.002で、簡単な確認にはブラウザーでも同じ決定的計算を実行できます。
技術的な質問
API経由の料金はいくらですか?
1リクエスト当たり$0.002です。ブラウザー版では同じ決定的計算をローカルで実行します。