HTTPのための構造化フィールド値

内部リストは0個以上の項目（Section 3.3）からなる配列です。個々の項目と内部リスト自体の両方がパラメータ化（Section 3.1.2）できます。

Example-List: ("foo" "bar"), ("baz"), ("bat" "one"), ()

この例の最後のメンバが空の内部リストである点に注意してください。

Example-List: ("foo"; a=1;b=2);lvl=5, ("bar" "baz");lvl=1

パーサは少なくとも 256 個のメンバを含む内部リストをサポートしなければなりません。フィールド仕様は必要に応じて個々の内部リストメンバの型や基数を制約できます。

パラメータは項目（Section 3.3）または内部リスト（Section 3.1.1）に関連付けられたキーと値の順序付けされたマップです。キーはそれが出現するパラメータの範囲内で一意であり、値は裸の項目（つまり、それ自体をパラメータ化できません；詳細は Section 3.3 を参照）です。

実装はインデックスおよびキーの両方でパラメータへアクセスできるようにしなければなりません。仕様はどちらのアクセス手段を使用してもよいとしています。

パラメータは順序付きであり、パラメータキーは大文字を含めることができない点に注意してください。

Example-List: abc;a=1;b=2; cde_456, (ghi;jk=4 l);q="9";r=w

Example-Integer: 1; a; b=?0

この要件はシリアライズ時のみのものである点に注意してください；パーサはパラメータに true の値が現れる場合でも正しく扱う必要があります。

パーサは項目または内部リストに少なくとも 256 個のパラメータと、少なくとも 64 文字のパラメータキーをサポートしなければなりません。フィールド仕様は個々のパラメータの順序や値の型を必要に応じて制約できます。

整数は -999,999,999,999,999 から 999,999,999,999,999（符号付きで最大15桁）までの範囲を持ちます。これは IEEE 754 との互換性のためです。

Example-Integer: 42

15 桁を超える整数は、文字列（Section 3.3.3）、バイト列（Section 3.3.5）、あるいはスケーリング係数として動作する整数パラメータを使うなど、様々な方法でサポートできます。

先頭にゼロを含む整数（例："0002", "-01"）や符号付きゼロ（"-0"）をシリアライズすることは可能ですが、これらの差異は実装によって保持されない場合があります。

この節の本文中での読みやすさのためのカンマはワイヤ形式では無効である点に注意してください。

小数は整数部と小数部を持つ数値です。整数部は最大12桁、小数部は最大3桁です。

Example-Decimal: 4.5

先頭ゼロ（例："0002.5", "-01.334"）、末尾ゼロ（例："5.230", "-0.40"）、および符号付きゼロ（例："-0.0"）でシリアライズすることは可能ですが、これらの差異は実装により保持されない場合があります。

シリアライズアルゴリズム（Section 4.1.5）は、小数部が3桁を超える入力を丸めます。別の丸め戦略が望ましい場合は、フィールド定義でシリアライズの前にそれを行うよう指定する必要があります。

文字列は0個以上の印字可能なASCII文字（RFC0020 に従う、つまり %x20 から %x7E の範囲）で構成されます。これにはタブ、改行、キャリッジリターンなどは含まれません。

非ASCII文字は相互運用性の問題を引き起こすため、文字列では直接サポートされません。ほとんどのフィールド値では非ASCIIを必要としないため、例外は少ないです。

フィールド値に非ASCIIコンテンツを伝える必要がある場合は、表示用文字列（Display String、Section 3.3.8）を指定できます。

Example-String: "hello world"

文字列の区切りには DQUOTE のみが使用され、シングルクォートは使用されない点に注意してください。さらに、エスケープ可能なのは DQUOTE と "\" のみであり、その他の文字に対する "\" はパース失敗を引き起こさなければなりません。

パーサはデコード後の文字列を少なくとも 1024 文字サポートしなければなりません。

トークンは短いテキスト単語で、アルファベット文字または "*" で始まり、その後に0個以上のトークン文字が続きます。トークン文字は RFC9110 の "token" ABNF ルールで許可される文字に ":" と "/" を追加したものと同じです。

Example-Token: foo123/456

パーサは少なくとも 512 文字のトークンをサポートしなければなりません。

トークンは既存の HTTP フィールドのデータモデルとの互換性のために主に定義されており、いくつかの実装では追加の手順が必要になる場合があります。その結果、新しいフィールドでは文字列の使用が推奨されます。

バイト列は Structured Fields で伝達できます。

Example-ByteSequence: :cHJldGVuZCB0aGlzIGlzIGJpbmFyeSBjb250ZW50Lg==:

パーサはデコード後に少なくとも 16384 オクテットのバイト列をサポートしなければなりません。

ブール値は Structured Fields で伝達できます。

Example-Boolean: ?1

辞書（Section 3.2）およびパラメータ（Section 3.1.2）の値においては、ブール true は値を省略することで示される点に注意してください。

日付値は Structured Fields で伝達できます。

日付は整数に類似したデータモデルを持ち、1970-01-01T00:00:00Z からの秒の差分（うるう秒を除く、負の値も可）を表します。したがって、テキスト形式でのシリアライズは整数に似ていますが、先頭に "@" を付けて区別されます。

Example-Date: @1659578233

パーサは年 1 から 9999 の全日を含む日付（すなわち 1970-01-01T00:00:00Z からの -62,135,596,800 から 253,402,214,400 秒の差分）をサポートしなければなりません。

表示文字列は文字列に似ており0個以上の文字から構成されますが、文字列とは異なり Unicode スカラー値（サロゲートを除くすべての Unicode コードポイント）を許容します。

表示文字列は最終ユーザへ表示される値のために設計されており、非ASCIIコンテンツを含む必要がある場合に使用されます。正規化や同字異形（homograph）攻撃など Unicode に関する処理上およびセキュリティ上の考慮事項があるため、文字列（Section 3.3.3）やトークン（Section 3.3.4）で足りる場合は表示文字列の使用は推奨されません。

表示文字列は値に使用されている言語を示すものではない点に注意してください；必要な場合は別途（例えばパラメータで）示すことができます。

テキスト形式の HTTP フィールドでは、表示文字列は文字列と類似した形で表現されますが、非ASCII文字はパーセントエンコードされます。これを文字列と区別するために先頭に "%" が付きます。

Example-DisplayString: %"This is intended for display to %c3%bcsers."

表示文字列を扱う際の追加のセキュリティ考慮事項については、Section 6 を参照してください。

入力として (member_value, parameters) タプルの配列 input_list が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. output を空の文字列とします。

2. input_list の各 (member_value, parameters) について：

   1. member_value が配列である場合、(member_value, parameters) に対して「内部リストのシリアライズ」(Section 4.1.1.1) を実行した結果を output に追加します。

   2. それ以外の場合、(member_value, parameters) に対して「項目のシリアライズ」(Section 4.1.3) を実行した結果を output に追加します。

   3. input_list にさらに member_values が残っている場合：

      1. "," を output に追加します。

      2. 単一の SP を output に追加します。

3. output を返します。

各メンバが member_key と (member_value, parameters) タプルを持つ順序付き Dictionary input_dictionary が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. output を空の文字列とします。

2. input_dictionary の各 member_key とその (member_value, parameters) について：

   1. メンバの member_key に対して「キーのシリアライズ」(Section 4.1.1.3) を実行した結果を output に追加します。

   2. member_value がブール true の場合：

      1. parameters に対して「パラメータのシリアライズ」(Section 4.1.1.2) を実行した結果を output に追加します。

   3. それ以外の場合：

      1. "=" を output に追加します。

      2. member_value が配列である場合、(member_value, parameters) に対して「内部リストのシリアライズ」(Section 4.1.1.1) を実行した結果を output に追加します。

      3. それ以外の場合、(member_value, parameters) に対して「項目のシリアライズ」(Section 4.1.3) を実行した結果を output に追加します。

   4. input_dictionary にさらにメンバが残っている場合：

      1. "," を output に追加します。

      2. 単一の SP を output に追加します。

3. output を返します。

bare_item として項目、item_parameters としてパラメータが与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. output を空の文字列とします。

2. bare_item に対して「裸の項目のシリアライズ」(Section 4.1.3.1) を実行した結果を output に追加します。

3. item_parameters に対して「パラメータのシリアライズ」(Section 4.1.1.2) を実行した結果を output に追加します。

4. output を返します。

input_integer が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_integer が -999,999,999,999,999 から 999,999,999,999,999 の範囲内の整数でない場合、シリアライズを失敗させます。

2. output を空の文字列とします。

3. input_integer が 0 より小さい（ただし 0 と等しくない）場合、"-" を output に追加します。

4. input_integer の数値を 10 進で、10 進数字のみを用いて表現したものを output に追加します。

5. output を返します。

input_decimal が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_decimal が小数でない場合、シリアライズを失敗させます。

2. input_decimal の小数点以下に 3 桁を超える有効数字がある場合、小数点以下 3 桁に丸めます。最終桁は最も近い値に丸め、等距離の場合は偶数へ丸めます。

3. 丸め後に小数点左側の有効数字が 12 桁を超える場合、シリアライズを失敗させます。

4. output を空の文字列とします。

5. input_decimal が 0 より小さい（ただし 0 と等しくない）場合、"-" を output に追加します。

6. input_decimal の整数部分を 10 進で（10 進数字のみを用いて） output に追加します。ゼロであれば "0" を追加します。

7. "." を output に追加します。

8. input_decimal の小数部分がゼロである場合、"0" を output に追加します。

9. それ以外の場合、input_decimal の小数部分の有効数字を 10 進で（10 進数字のみを用いて） output に追加します。

10. output を返します。

input_string が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_string を ASCII 文字列の列に変換します。変換に失敗した場合、シリアライズを失敗させます。

2. input_string に %x00-1f または %x7f-ff（すなわち VCHAR または SP に含まれない文字）が含まれている場合、シリアライズを失敗させます。

3. output を DQUOTE の文字列とします。

4. input_string の各文字 char について：

   1. char が "\" または DQUOTE の場合：

      1. "\" を output に追加します。

   2. char を output に追加します。

5. DQUOTE を output に追加します。

6. output を返します。

input_token が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_token を ASCII 文字列の列に変換します。変換に失敗した場合、シリアライズを失敗させます。

2. input_token の最初の文字が ALPHA または "*" でない、あるいは残りの部分に tchar、":"、"/" に含まれない文字がある場合、シリアライズを失敗させます。

3. output を空の文字列とします。

4. input_token を output に追加します。

5. output を返します。

input_bytes が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_bytes がバイト列でない場合、シリアライズを失敗させます。

2. output を空の文字列とします。

3. ":" を output に追加します。

4. [RFC4648] の規定に従い input_bytes を base64 エンコードした結果（以下の要件を考慮）を output に追加します。

5. ":" を output に追加します。

6. output を返します。

エンコードされたデータは [RFC4648] の規定に従って "=" でパディングされている必要があります。

同様に、エンコードデータは可能であれば pad ビットをゼロにすることが [RFC4648] の推奨ですが、実装上不可能な場合は例外とできます。

input_boolean が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_boolean が真偽値でない場合、シリアライズを失敗させます。

2. output を空の文字列とします。

3. "?" を output に追加します。

4. input_boolean が true の場合、"1" を output に追加します。

5. input_boolean が false の場合、"0" を output に追加します。

6. output を返します。

input_date が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. output を "@" とします。

2. input_date に対して「整数のシリアライズ」(Section 4.1.4) を実行した結果を output に追加します。

3. output を返します。

Unicode コードポイントの列 input_sequence が与えられたとき、HTTP フィールド値で使用可能な ASCII 文字列を返します。

1. input_sequence が Unicode コードポイントの列でない場合、シリアライズを失敗させます。

2. byte_array を input_sequence に UTF-8 エンコーディング（Section 3 of [UTF8]）を適用した結果とします。エンコードが失敗した場合、シリアライズを失敗させます。

3. encoded_string を "%" に続けて DQUOTE を含む文字列とします。

4. byte_array の各バイトについて：

   1. バイトが %x25 ("%")、%x22 (DQUOTE)、または %x00-1f や %x7f-ff の範囲にある場合：

      1. "%" を encoded_string に追加します。

      2. encoded_byte を byte に対して base16 エンコード（Section 8 of [RFC4648]）した結果とし、アルファベット文字があれば小文字に変換します。

      3. encoded_byte を encoded_string に追加します。

   2. それ以外の場合、バイトを ASCII 文字としてデコードし、その結果を encoded_string に追加します。

5. DQUOTE を encoded_string に追加します。

6. encoded_string を返します。

[UTF8] は U+D800 から U+DFFF（サロゲート）間のコードポイントのエンコードを禁止しています。入力にそれらが含まれる場合、シリアライズは失敗します。

ASCII 文字列 input_string が与えられたとき、(item_or_inner_list, parameters) タプルの配列を返します。input_string は解析された値を削除するように変更されます。

1. members を空の配列とします。

2. input_string が空でない間：

   1. input_string に対して「項目または内部リストの解析」(Section 4.2.1.1) を実行した結果を members に追加します。

   2. input_string の先頭の OWS を破棄します。

   3. input_string が空であれば、members を返します。

   4. input_string の最初の文字を消費します。それが "," でなければ、解析を失敗させます。

   5. input_string の先頭の OWS を破棄します。

   6. input_string が空であれば、末尾のカンマがあるので解析を失敗させます。

3. 構造化データが見つからなかった場合、members（空）を返します。

ASCII 文字列 input_string が与えられたとき、値が (item_or_inner_list, parameters) タプルである順序付けられたマップを返します。input_string は解析された値を削除するように変更されます。

1. dictionary を空の順序付けマップとします。

2. input_string が空でない間：

   1. input_string に対して「キーの解析」(Section 4.2.3.3) を実行した結果を this_key とします。

   2. input_string の最初の文字が "=" である場合：

      1. input_string の最初の文字を消費します。

      2. input_string に対して「項目または内部リストの解析」(Section 4.2.1.1) を実行した結果を member とします。

   3. それ以外の場合：

      1. value をブール true とします。

      2. input_string に対して「パラメータの解析」(Section 4.2.3.2) を実行した結果を parameters とします。

      3. member を (value, parameters) タプルとします。

   4. dictionary が既に this_key を含んでいる場合（文字ごとに比較）、その値を member で上書きします。

   5. それ以外の場合、this_key を key として member を dictionary に追加します。

   6. input_string の先頭の OWS を破棄します。

   7. input_string が空であれば、dictionary を返します。

   8. input_string の最初の文字を消費します。それが "," でなければ解析を失敗させます。

   9. input_string の先頭の OWS を破棄します。

   10. input_string が空であれば、末尾のカンマがあるので解析を失敗させます。

3. 構造化データが見つからなかった場合、dictionary（空）を返します。

重複する辞書キーが見つかった場合、最後のインスタンス以外は無視される点に注意してください。

ASCII 文字列 input_string が与えられたとき、(bare_item, parameters) タプルを返します。input_string は解析された値を削除するように変更されます。

1. input_string に対して「裸の項目の解析」(Section 4.2.3.1) を実行した結果を bare_item とします。

2. input_string に対して「パラメータの解析」(Section 4.2.3.2) を実行した結果を parameters とします。

3. (bare_item, parameters) タプルを返します。

ASCII 文字列 input_string が与えられたとき、整数または小数を返します。input_string は解析された値を削除するように変更されます。

注: このアルゴリズムは整数（Section 3.3.1）と小数（Section 3.3.2）の両方を解析し、対応する構造を返します。

1. type を "integer" とします。

2. sign を 1 とします。

3. input_number を空の文字列とします。

4. input_string の最初の文字が "-" であれば、それを消費して sign を -1 に設定します。

5. input_string が空であれば、空の整数があるので解析を失敗させます。

6. input_string の最初の文字が DIGIT でない場合、解析を失敗させます。

7. input_string が空でない間：

   1. input_string の最初の文字を消費し、それを char とします。

   2. char が DIGIT であれば、それを input_number に追加します。

   3. そうでなく、type が "integer" で char が "." である場合：

      1. input_number が 12 文字を超えている場合、解析を失敗させます。

      2. それ以外の場合、char を input_number に追加し、type を "decimal" に設定します。

   4. それ以外の場合、char を input_string の先頭に戻し、ループを抜けます。

   5. type が "integer" で input_number が 15 文字を超える場合、解析を失敗させます。

   6. type が "decimal" で input_number が 16 文字を超える場合、解析を失敗させます。

8. type が "integer" の場合：

   1. output_number を input_number を整数として解析した結果の Integer とします。

9. それ以外の場合：

   1. input_number の最後の文字が "." の場合、解析を失敗させます。

   2. input_number の "." の後の文字数が 3 を超える場合、解析を失敗させます。

   3. output_number を input_number を小数として解析した結果の Decimal とします。

10. output_number を output_number と sign の積とします。

11. output_number を返します。

ASCII 文字列 input_string が与えられたとき、引用解除された文字列を返します。input_string は解析された値を削除するように変更されます。

1. output_string を空の文字列とします。

2. input_string の最初の文字が DQUOTE でない場合、解析を失敗させます。

3. input_string の最初の文字を破棄します。

4. input_string が空でない間：

   1. input_string の最初の文字を消費し、それを char とします。

   2. char がバックスラッシュ ("\") の場合：

      1. input_string が空であれば、解析を失敗させます。

      2. input_string の最初の文字を消費し、それを next_char とします。

      3. next_char が DQUOTE または "\" でない場合、解析を失敗させます。

      4. next_char を output_string に追加します。

   3. そうでなく、char が DQUOTE である場合、output_string を返します。

   4. そうでなく、char が %x00-1f または %x7f-ff の範囲にある場合（すなわち VCHAR または SP に含まれない場合）、解析を失敗させます。

   5. それ以外の場合、char を output_string に追加します。

5. 閉じる DQUOTE を見つけずに input_string の終わりに到達したため、解析を失敗させます。

ASCII 文字列 input_string が与えられたとき、トークンを返します。input_string は解析された値を削除するように変更されます。

1. input_string の最初の文字が ALPHA または "*" でない場合、解析を失敗させます。

2. output_string を空の文字列とします。

3. input_string が空でない間：

   1. input_string の最初の文字が tchar、":"、または "/" に含まれない場合、output_string を返します。

   2. input_string の最初の文字を消費し、それを char とします。

   3. char を output_string に追加します。

4. output_string を返します。

ASCII 文字列 input_string が与えられたとき、バイト列を返します。input_string は解析された値を削除するように変更されます。

1. input_string の最初の文字が ":" でない場合、解析を失敗させます。

2. input_string の最初の文字を破棄します。

3. input_string の終端までに ":" 文字が存在しない場合、解析を失敗させます。

4. b64_content を input_string の先頭から最初に現れる ":" 文字を含まない部分まで消費した結果とします。

5. input_string の先頭の ":" を消費します。

6. b64_content が ALPHA、DIGIT、"+", "/", "=" に含まれない文字を含む場合、解析を失敗させます。

7. 必要に応じてパディングを合成しつつ、[RFC4648] に従って b64_content を base64 デコードした結果を binary_content とします。base64 デコードに失敗した場合、解析は失敗します。

8. binary_content を返します。

base64 の実装の中には "=" で適切にパディングされていないエンコードデータの拒否を許さないものがあるため、パーサは "=" のパディングが存在しない場合に失敗すべきではありません（設定が不可能な場合を除く）。

また、base64 の実装の中には非ゼロの pad ビットを含むエンコードデータの拒否を許さないものがあるため、パーサは非ゼロの pad ビットが存在する場合に失敗すべきではありません（設定が不可能な場合を除く）。

本仕様は [RFC4648] の Sections 3.1 および 3.3 の要件を緩和するものではありません。したがって、パーサは base64 アルファベット外の文字やエンコードデータ内の改行に対しては失敗しなければなりません。

ASCII 文字列 input_string が与えられたとき、ブール値を返します。input_string は解析された値を削除するように変更されます。

1. input_string の最初の文字が "?" でない場合、解析を失敗させます。

2. input_string の最初の文字を破棄します。

3. input_string の最初の文字が "1" に一致する場合、その文字を破棄し、true を返します。

4. input_string の最初の文字が "0" に一致する場合、その文字を破棄し、false を返します。

5. どの値にも一致しないため、解析を失敗させます。

ASCII 文字列 input_string が与えられたとき、日付を返します。input_string は解析された値を削除するように変更されます。

1. input_string の最初の文字が "@" でない場合、解析を失敗させます。

2. input_string の最初の文字を破棄します。

3. input_string に対して「整数または小数の解析」(Section 4.2.4) を実行した結果を output_date とします。

4. output_date が小数である場合、解析を失敗させます。

5. output_date を返します。

ASCII 文字列 input_string が与えられたとき、Unicode コードポイントの列を返します。input_string は解析された値を削除するように変更されます。

1. input_string の最初の 2 文字が "%" に続いて DQUOTE でない場合、解析を失敗させます。

2. input_string の最初の 2 文字を破棄します。

3. byte_array を空のバイト配列とします。

4. input_string が空でない間：

   1. input_string の最初の文字を消費し、それを char とします。

   2. char が %x00-1f または %x7f-ff の範囲にある場合（すなわち VCHAR または SP に含まれない場合）、解析を失敗させます。

   3. char が "%" である場合：

      1. octet_hex を input_string から 2 文字消費した結果とします。2 文字が存在しない場合、解析を失敗させます。

      2. octet_hex が %x30-39 または %x61-66（0-9 または 小文字 a-f）以外の文字を含む場合、解析を失敗させます。

      3. octet を hex デコードした結果とします（Section 8 of [RFC4648]）。

      4. octet を byte_array に追加します。

   4. char が DQUOTE である場合：

      1. byte_array を UTF-8 としてデコードした結果を unicode_sequence とします。デコードに失敗した場合、解析を失敗させます（Section 3 of [UTF8] に準拠）。

      2. unicode_sequence を返します。

   5. それ以外で、char が "%" でも DQUOTE でもない場合：

      1. char を ASCII エンコーディングでバイトに変換した結果を byte とします。

      2. byte を byte_array に追加します。

5. 閉じる DQUOTE を見つけずに input_string の終わりに到達したため、解析を失敗させます。