nl::Weave::TLV::TLVWriter

TLV 부동 소수점 값을 인코딩합니다.

이는 오버로드된 멤버 함수로, 편의를 위해 제공됩니다. 위의 함수와 허용되는 인수만 다릅니다.

TLV 불리언 값을 인코딩합니다.

TLV 바이트 문자열 값을 인코딩합니다.

TLV null 값을 인코딩합니다.

사전 인코딩된 멤버 요소 집합에서 TLV 컨테이너 요소를 인코딩합니다.

PutPreEncodedContainer() 메서드는 사전 인코딩된 버퍼에서 가져온 멤버 요소 집합을 포함하는 새로운 TLV 컨테이너 요소 (구조, 배열 또는 경로)를 인코딩합니다. 입력 버퍼는 0개 이상의 완전히 인코딩된 TLV 요소를 포함하고, 지정된 컨테이너 유형과 관련된 규칙을 준수하는 태그를 포함해야 합니다 (예: 구조 멤버에는 태그가 있어야 하지만 배열 멤버는 없어야 함).

이 메서드는 한 번의 호출로 컨테이너 요소 전체를 인코딩합니다. PutPreEncodedContainer()가 반환되면 작성기 객체를 사용하여 컨테이너 요소 다음에 추가 TLV 요소를 작성할 수 있습니다.

TLV UTF8 문자열 값을 인코딩합니다.

TLV UTF8 문자열 값을 인코딩합니다.

TLV 요소의 형식에 따라 형식이 지정된 문자열 출력을 인코딩합니다.

PutStringF는 문자 버퍼가 아닌 TLV 요소에 출력이 저장되는 sprintf의 아날로그입니다. 확장된 printf 기능을 사용할 수 있는 경우 이 함수는 결과 문자열을 비연속 기본 저장소에 출력할 수 있습니다. 구현은 다음과 같은 printf 개선사항을 지원합니다.

플랫폼은 putchar 대신 맞춤 콜백을 호출하는 기능을 제공하는 콜백 기반 vcbprintf를 제공합니다.

플랫폼은 vsnprintf_ex라는 vsnprintf의 변형을 제공합니다. 이 변형은 출력의 처음 n 문자를 생략하는 조항이 있다는 점을 제외하고 vsnprintf와 동일하게 동작합니다.

콜백 기반 함수가 가장 간단하고 코드를 가장 적게 사용하지만 vsprintf_ex 다양한 함수는 스택을 더 적게 사용합니다.

위의 두 메서드를 모두 사용할 수 없지만 플랫폼에서 malloc를 제공하는 경우 이 함수는 출력을 저장할 임시 버퍼를 할당합니다. 플랫폼이 printf 계열이나 malloc에 개선사항을 제공하지 않으면 현재 TLV 저장소의 연속 상태에 맞도록 출력이 잘립니다.

새로운 TLV 컨테이너 요소의 인코딩을 시작합니다.

StartContainer() 메서드는 TLV 컨테이너 요소 (구조, 배열, 경로)를 인코딩에 작성하는 데 사용됩니다. 메서드는 새 컨테이너의 유형과 태그 (있는 경우)와 TLVType 값에 대한 참조를 가져옵니다. 이 참조는 컨테이너를 작성하는 데 사용되는 동안 작성자의 현재 컨텍스트를 저장하는 데 사용됩니다.

StartContainer() 메서드가 반환되면 애플리케이션은 현재 TLVWriter 객체를 사용하여 컨테이너의 요소를 작성해야 합니다. 완료되면 애플리케이션에서 EndContainer() 메서드를 호출하여 컨테이너 인코딩을 완료해야 합니다.

TLV 바이트 문자열을 여러 청크로 인코딩합니다.

ContinuePutBytes와 함께 사용해야 합니다.

TLV 요소의 형식에 따라 형식이 지정된 문자열 출력을 인코딩합니다.

PutStringF는 문자 버퍼가 아닌 TLV 요소에 출력이 저장되는 sprintf의 아날로그입니다. 확장된 printf 기능을 사용할 수 있는 경우 이 함수는 결과 문자열을 비연속 기본 저장소에 출력할 수 있습니다. 구현은 다음과 같은 printf 개선사항을 지원합니다.

플랫폼은 putchar 대신 맞춤 콜백을 호출하는 기능을 제공하는 콜백 기반 vcbprintf를 제공합니다.

플랫폼은 vsnprintf_ex라는 vsnprintf의 변형을 제공합니다. 이 변형은 출력의 처음 n 문자를 생략하는 조항이 있다는 점을 제외하고 vsnprintf와 동일하게 동작합니다.

콜백 기반 함수가 가장 간단하고 코드를 가장 적게 사용하지만 vsprintf_ex 다양한 함수는 스택을 더 적게 사용합니다.

위의 두 메서드를 모두 사용할 수 없지만 플랫폼에서 malloc를 제공하는 경우 이 함수는 출력을 저장할 임시 버퍼를 할당합니다. 플랫폼이 printf 계열이나 malloc에 개선사항을 제공하지 않으면 현재 TLV 저장소의 연속 상태에 맞도록 출력이 잘립니다.

PacketBuffer 체인에 쓰기 위한 TLVWriter FinalizeBuffer 함수의 구현입니다.

FinalizePacketBuffer() 함수는 TLVWriter를 사용하여 PacketBuffer 체인에 쓸 때 필요한 완료 작업을 수행합니다. 이 함수는 GetNewPacketBuffer() 함수와 함께 사용하도록 설계되었습니다.

FinalizePacketBuffer() 함수의 API에 대한 자세한 내용은 FinalizeBufferFunct 유형 정의를 참조하세요.

동적 버퍼에 쓰기 위한 TLVWriter GetNewBuffer 함수의 구현입니다.

GetNewBuffer_Malloced() 함수는 인코딩을 저장하는 데 필요한 기본 동적 버퍼 크기를 두 배로 늘려 TLVWriter에 새 출력 공간을 제공합니다. 이 함수는 TLVWriter GetNewBuffer 함수 포인터에 할당되도록 설계되었습니다.

GetNewBuffer_Malloced() 함수의 API에 대한 자세한 내용은 GetNewBufferFunct 유형 정의를 참조하세요.

PacketBuffer 체인에 쓰기 위한 TLVWriter GetNewBuffer 함수의 구현입니다.

GetNewPacketBuffer() 함수는 인코딩을 저장하는 데 필요한 경우 하나 이상의 PacketBuffer 체인을 할당하여 TLVWriter에 새 출력 공간을 제공합니다. 이 함수는 TLVWriter GetNewBuffer 함수 포인터에 할당되도록 설계되었습니다.

GetNewPacketBuffer를 TLVWriter와 함께 사용할 때는 해당하는 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
)