ネットストリング

コンピュータプログラミングにおいて、ネットストリングとは、宣言的な表記法を使用して文字列のサイズを示すバイト文字列のフォーマット方法です。 ^{[1] [2]}

ネット文字列は、後続のデータのバイト長を格納するため、区切り文字または終了文字 (ヌル文字など)として解釈される可能性のある値に敏感なプログラム間でテキストとバイト データを明確に渡すことが容易になります。

形式は、ASCII 数字を使用して記述された文字列の長さ、コロン、バイト データ、およびカンマで構成されます。このコンテキストでの「長さ」は「8 ビット単位の数」を意味するため、たとえば文字列がUTF-8 を使用してエンコードされている場合、これは文字列内に存在するテキスト文字の数と同じ場合も、同じでない場合もあります。

たとえば、「hello world!」というテキストは次のようにエンコードされます。

< 31 32  3a 68 65 6c 6c 6f 20 77 6f 72 6c 64 21 2c >
  

つまり

12 :こんにちは世界！、

空の文字列は次のようになります。

< 30 3a 2c >
  

つまり

0 : 、

カンマを使用すると、隣接するレコードとして使用されるネット文字列を人間が読みやすくなり、正しい解析の検証が弱くなります。カンマがない場合、形式はBencode が文字列をエンコードする方法を反映していることに注意してください。

長さは先頭のゼロなしで書き込まれます。ゼロで始まるネット文字列は空の文字列のみです。任意のバイト文字列に対して、有効なネット文字列エンコーディングは 1 つだけです。

この形式は生成と解析が簡単なので、さまざまなプログラミング言語で書かれたプログラムで簡単にサポートできます。 実際には、ネットストリングはバイト文字列またはバイト文字列のリストの交換を簡素化するためによく使用されます。 たとえば、Simple Common Gateway Interface (SCGI) やQuick Mail Queuing Protocol (QMQP) での使用例をご覧ください。

Netstrings は、任意のデータを区切り形式で埋め込む際に発生する複雑さを回避します。たとえば、XML には特定のバイト値が含まれていない場合があり、エスケープと区切りの重要な組み合わせが必要になります。一方、マルチパート MIME メッセージを生成するには、データの内容と衝突してはならない区切り文字を選択する必要があります。

ネット文字列は再帰的に保存できます。文字列のシーケンスをエンコードすると、単一の文字列になります。上記の「hello world!」の例を、2 つのネット文字列のシーケンスに書き直し、それ自体を単一のネット文字列としてエンコードすると、次のようになります。

17 : 5 :こんにちは、6 :世界! 、、

このようなネストされたネット文字列の解析は、含まれる文字列 ("5:hello,6:world!,") が文字列であると同時にネット文字列のシーケンスでもあるため、ダックタイピングの例です。その有効な型は、ネット文字列仕様で要求される明示的な型宣言ではなく、アプリケーションがそれを解釈する方法によって決まります。一般に、ネット文字列を期待するプログラムがその内容を解釈する方法は 3 つあります。

• 人間が読めるテキストとして、それ以上の自動処理は行われない
• 事前に決められた固定データシリアル化形式でカプセル化されたデータとして（CまたはC++構造体のバイナリコンテンツなど）
• カプセル化されたメタデータとデータとして、タグ付きユニオン規則を使用してネストされたネットストリングのタイプを記述し、自己記述型の階層データシリアル化形式を確立します。（「タグ付きネットストリング」とBencodeは、同様の自己記述型の階層形式をサポートするネットストリングの拡張機能と見なすことができます^{[3] [4] [5] [6] [7]}）

ネットストリングは格納するデータの内容に制限を設けないため、ほとんどの区切り形式にネットストリングをそのまま埋め込むと、含まれる形式の区切りが妨げられる可能性があることに注意してください。

ネットワーク プログラミングのコンテキストでは、受信側プログラムに後続のデータのサイズが通知されると、受信側プログラムが正確に十分なメモリを割り当て、より多くのデータを収容するための再割り当ての必要性を回避し、サイズ制限を超えるデータを事前に拒否できるため、潜在的に有用です。

• ホレリス定数

• http://cr.yp.to/proto/netstrings.txt
• http://wiki.tcl.tk/15074