ForHosting KIT · 開発者向けツール

UTF-16 コードユニット変換

Hiはビッグエンディアンで00480069、つまりコードユニット2つ、4バイトになります。リトルエンディアンにするとHは48 00です。16進ダンプを貼り付ければ文字として読め、壊れたサロゲートペアは受け付けません。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
テキスト
Hi
計算モード
Encode
エンディアン
Be
結果
結果
00480069
コード単位
2
バイト
4

本ツールは平文をそれらのコードユニットの連続した16進ダンプへ変換し、またはその逆を行いながら、各ユニットについてビッグエンディアンかリトルエンディアンかの並びをお選びいただけます。基本多言語面の外の文字を表すサロゲートペアはそのまま保たれます。

UTF-16コードユニットとは何か、なぜ16進が役立つか

基本多言語面のUnicodeスカラー値は、1つの16ビットコードユニットに収まります。その面の外の文字、すなわち絵文字、多くの歴史的文字、まれな記号は、サロゲートペアを用います。U+D800〜U+DBFFの範囲の上位サロゲートに続いて、U+DC00〜U+DFFFの下位サロゲートが並びます。

エンコードはテキストを大文字の連続した16進に変え、2桁ごとに1バイト、4桁ごとに、お選びいただいたエンディアンの下での1コードユニットになります。デコードはその経路を逆にたどります。16進文字列中の空白、コロン、下線、ハイフンは無視されるため、ログ行やパケットキャプチャからのダンプを別途の整形なしに貼り付けられます。

変換は純粋なローカル解析作業であるため、同一の入力は常にモデルのぶれもネットワーク依存もなく同一の出力を生みます。

エンディアン、モード選択、整形式性の規則

モードの既定値は encode です。平文を与えると16進を受け取ります。入力がすでにUTF-16バイトの16進表現である場合は、モードを decode に切り替えてください。

endian の既定値は be(ビッグエンディアン)で、U+0048 はバイト対 00 48 になります。リトルエンディアンの 48 00 には le をお選びください。これは多くのWindowsやARMのメモリ配置に合致します。

エンディアンは各コードユニットに独立して適用されます。BOMの自動付加や除去はありません。BOMが必要な場合は、おなじみの FEFF パターンを明示的なユニットとしてご自身で追加または削除してください。

デコードは、各コードユニットが2バイトであるため、整形後の16進の長さが4の倍数であることを要求します。エンコードとデコードの両方で、ストリームは不対サロゲートについて検査されます。下位ユニットが続かない上位ユニット、上位ユニットが先行しない下位ユニット、入力末尾で途切れたペアはすべて失敗します。

この規則は、ダンプが文字の途中で切れていたり、文字列にすでに孤立したサロゲートが含まれていたりする場合の無言の破損を防ぎます。

フィクスチャとテストデータの生成

エンコード長、サロゲートペア、エンディアン固有の配置を検証する単体テスト向けに、決定論的な16進フィクスチャを生成します。

サポートとリバースエンジニアリング

顧客提供のUTF-16 16進ダンプを読めるテキストへ復号しつつ、途切れたストリームや不対サロゲートを拒否します。

be と le の違いは何ですか?

be(ビッグエンディアン)は各16ビットユニットで上位バイトを先に格納し、le(リトルエンディアン)は下位バイトを先に格納します。対象形式が期待する配置をお選びください。

不対サロゲートがあると何が起きますか?

部分的な16進やテキストは返されず、失敗した呼び出しは課金されません。

空白やコロンを含む16進を貼り付けられますか?

decode モードでは可能です。空白、下線、コロン、ハイフンは解析前に除去されます。残った桁は完全な2バイトのコードユニットを構成する必要があります。

絵文字はUTF-16でどう表されますか?

サロゲートペアと呼ばれる2つのコードユニットを使います。D800からDBFFの上位の半分に、DC00からDFFFの下位の半分が続きます。見える1文字に対して16進では2単位が並び、2つは必ず一緒に扱います。

バイト順マークは自動で付きますか?

いいえ。エンコード時に先頭へ何かを足すことも、デコード時に取り除くこともしません。ファイルや通信でFEFFのマークが必要なら、明示的な1単位として自分で加えるか、貼り付ける前にダンプから外してください。

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

POSThttps://api.kit.forhosting.com/enc/utf16

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

curl -X POST https://api.kit.forhosting.com/enc/utf16 \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hi"}'
{
  "text": "Hi"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.utf16",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

UTF-16は今なお、Windows API、多くのバイナリプロトコル、JavaScript文字列の内部表現、そして生のUTF-8バイトではなく16ビットのコードユニットで語る交換形式の背後にある、通信路とメモリの形式です。不対の上位または下位サロゲートは、曖昧なバイトを生成する代わりに明確な invalid_input エラーで失敗します。同じ決定論的な経路が、無料のブラウザフォームと、成功1リクエストあたり$0.002のAPIの両方を支えます。

UTF-16コードユニットとは何か、なぜ16進が役立つか

プロトコルのダンプ、クリップボードのペイロード、タグの誤ったファイルをデバッグするには、どのバイトがどれかを推測するのではなく、それらのユニットを16進として読むことがしばしば必要になります。応答は常に、生成されたコードユニット数とバイト数を報告するため、バイナリ仕様の長さフィールドと比較しやすくなります。

エンディアン、モード選択、整形式性の規則

無効な mode や endian の値も、フィールド固有のメッセージで即座に失敗するため、クライアントが推測せずにリクエストを修正できます。

どこで実行するか、価格の仕組み

一度きりの検査、たとえばWindowsレジストリのエクスポートからのUTF-16LEダンプの読み取り、絵文字が2つのコードユニットに展開される様子の確認、相手のビッグエンディアン16進が自分のテキストと一致するかの確認には、無料のブラウザ内ツールをお使いください。不対サロゲートや不正な16進を含む検証失敗は課金されないため、不良ダンプの調査でプリペイド残高が減ることはありません。本機能はtier-Aの解析作業であるため、レイテンシは低く保たれ、デプロイのたびに再測定すべきコンテナやモデルのコストはありません。同じ純粋な関数は、テストでフィクスチャを正規化したり、プロトコルの例を文書化したり、変換表をすべてのサービスに埋め込まずにパイプライン内でLEとBEの混在サンプルを変換したりする必要があるとき、APIを支えます。成功したAPI呼び出しごとに$0.002がかかります。応答は決定論的なJSONで、変換結果、解決された mode と endian、コードユニット数とバイト数を含みます。この呼び出しを、リバースエンジニアリングのノートブック、通信形式の一致を検証するQAハーネス、あるいは顧客が16進を貼り付け、16進エディタを開かずに読める文字列が必要なサポート業務に組み込んでください。

プロトコルとバイナリ形式のデバッグ

人間のテキストをビッグまたはリトルエンディアンのUTF-16 16進に変え、パケットキャプチャ、Windows APIバッファ、仕様の例と比較します。

encode モードは何を返しますか?

選択したエンディアンの下でのテキストのUTF-16バイトの、大文字の連続した16進と、code_units およびバイト数です。BOMは自動的には付加されません。

APIの費用はいくらですか?

成功1リクエストあたり$0.002です。ブラウザ版は無料です。無効な入力は課金されません。

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