nl::Weave::TLV::TLVWriter

TLV 浮動小数点値をエンコードします。

これはオーバーロードされたメンバー関数であり、便宜上提供されています。上記の関数との違いは、受け付ける引数のみです。

TLV ブール値をエンコードします。

TLV バイト文字列値をエンコードします。

TLV の null 値をエンコードします。

事前にエンコードされたメンバー要素のセットから TLV コンテナ要素をエンコードします。

PutPreEncodedContainer() メソッドは、事前にエンコードされたバッファから取得したメンバー要素のセットを含む新しい TLV コンテナ要素（構造、配列、パス）をエンコードします。入力バッファには、指定されたコンテナタイプに関連付けられたルールに準拠するタグを含む 0 個以上のフルエンコード TLV 要素が含まれている必要があります（たとえば、構造体メンバーにはタグが必要ですが、配列メンバーにはタグがありません）。

このメソッドは 1 回の呼び出しでコンテナ要素全体をエンコードします。PutPreEncodedContainer() から返されたら、ライター オブジェクトを使用して、コンテナ要素の後に追加の TLV 要素を書き込むことができます。

TLV UTF8 文字列値をエンコードします。

TLV UTF8 文字列値をエンコードします。

TLV 要素の形式に従ってフォーマットされた文字列出力をエンコードします。

PutStringF は sprintf に類似しており、出力は文字バッファではなく TLV 要素に格納されます。拡張された printf 機能が使用可能な場合、関数は、結果の文字列を不連続な基盤となるストレージに出力できます。この実装では、次の printf の拡張機能がサポートされています。

プラットフォームには、putchar の代わりにカスタム コールバックを呼び出す機能を提供する、コールバック ベースの vcbprintf が用意されています。

プラットフォームは vsnprintf_ex という vsnprintf のバリアントを提供します。これは vsnprintf とまったく同じように動作しますが、出力の最初の n 文字を省略するためのプロビジョニングがあります。

コールバック ベースの関数は最もシンプルで、使用するコードの量も最も少ないものの、さまざまな関数 vsprintf_ex のほうがスタックの消費量が少なくなります。

上記のいずれも使用できない場合でも、プラットフォームが malloc を提供している場合、関数は出力を保持するために一時バッファを割り当てます。プラットフォームが printf ファミリーと malloc のどちらの拡張機能も提供していない場合、現在の TLV ストレージの連続状態に収まるように出力が切り捨てられます

新しい TLV コンテナ要素のエンコードを開始します。

StartContainer() メソッドは、TLV コンテナ要素（構造、配列、パス）をエンコードに書き込むために使用されます。このメソッドは、新しいコンテナのタイプとタグ（存在する場合）と、TLVType 値への参照を受け取ります。TLVType 値は、コンテナの書き込み中に書き込みの現在のコンテキストを保存するために使用されます。

StartContainer() メソッドが返されたら、アプリケーションは現在の TLVWriter オブジェクトを使用してコンテナの要素を書き込む必要があります。完了したら、アプリケーションで EndContainer() メソッドを呼び出して、コンテナのエンコードを終了する必要があります。

TLV バイト文字列を複数のチャンクにエンコードします。

これは ContinuePutBytes とともに使用する必要があります。

TLV 要素の形式に従ってフォーマットされた文字列出力をエンコードします。

PutStringF は sprintf に類似しており、出力は文字バッファではなく TLV 要素に格納されます。拡張された printf 機能が使用可能な場合、この関数は結果の文字列を不連続な基盤となるストレージに出力できます。この実装では、次の printf の拡張機能がサポートされています。

プラットフォームには、putchar の代わりにカスタム コールバックを呼び出す機能を提供する、コールバック ベースの vcbprintf が用意されています。

プラットフォームは vsnprintf_ex という vsnprintf のバリアントを提供します。これは vsnprintf とまったく同じように動作しますが、出力の最初の n 文字を省略するためのプロビジョニングがあります。

コールバック ベースの関数は最もシンプルで、使用するコードの量も最も少ないものの、さまざまな関数 vsprintf_ex のほうがスタックの消費量が少なくなります。

上記のいずれも使用できない場合でも、プラットフォームが malloc を提供している場合、関数は出力を保持するために一時バッファを割り当てます。プラットフォームが printf ファミリーと malloc のどちらの拡張機能も提供していない場合、現在の TLV ストレージの連続状態に収まるように出力が切り捨てられます

PacketBuffer のチェーンに書き込むための TLVWriter FinalizeBuffer 関数の実装。

FinalizePacketBuffer() 関数は、TLVWriter を使用して PacketBuffer のチェーンに書き込む際に必要なファイナライズを実行します。この関数は、GetNewPacketBuffer() 関数と組み合わせて使用するように設計されています。

FinalizePacketBuffer() 関数の API の詳細については、FinalizeBufferFunct 型の定義をご覧ください。

動的バッファに書き込むための TLVWriter GetNewBuffer 関数の実装。

GetNewBuffer_Malloced() 関数は、エンコードを保存するために必要に応じて基盤となる動的バッファのサイズを 2 倍にすることで、新しい出力空間を TLVWriter に提供します。この関数は、TLVWriter の GetNewBuffer 関数ポインタに割り当てられるように設計されています。

GetNewBuffer_Malloced() 関数の API の詳細については、GetNewBufferFunct 型の定義をご覧ください。

PacketBuffer のチェーンに書き込むための TLVWriter GetNewBuffer 関数の実装。

GetNewPacketBuffer() 関数は、エンコードを格納するために必要に応じて 1 つ以上の PacketBuffers のチェーンを割り当てることで、TLVWriter に新しい出力スペースを提供します。この関数は、TLVWriter の GetNewBuffer 関数ポインタに割り当てられるように設計されています。

TLVWriter で GetNewPacketBuffer を使用する場合は、対応する FinalizePacketBuffer() 関数（または同等の関数）を使用してバッファ チェーンを確定する必要もあります。

GetNewPacketBuffer() 関数の API の詳細については、GetNewBufferFunct 型の定義をご覧ください。

コンテナを起動または開く時点で、CloseContainer シンボル用のスペースを予約するかどうかを指定します。

SetCloseContainerReserved

void SetCloseContainerReserved(
  bool aCloseContainerReserved
)

SetContainerOpen

void SetContainerOpen(
  bool aContainerOpen
)

WEAVE_ERROR WriteData(
  const uint8_t *p,
  uint32_t len
)

WEAVE_ERROR WriteElementHead(
  TLVElementType elemType,
  uint64_t tag,
  uint64_t lenOrVal
)

WEAVE_ERROR WriteElementWithData(
  TLVType type,
  uint64_t tag,
  const uint8_t *data,
  uint32_t dataLen
)