Struct AttrDataBuilder 

pub struct AttrDataBuilder<P, const F: usize = 0> { /* private fields */ }

Streaming builder for a single AttrData entry inside the WriteRequests array.

Field-state values:

• 0: nothing written yet
• 1: DataVersion decided
• 2: Path written
• 3: Data written (struct can be closed)

Implementations

impl<P> AttrDataBuilder<P>

where P: TLVBuilderParent,

pub fn new(p: P, tag: &TLVTag) -> Result<AttrDataBuilder<P>, Error>

Begin a new AttrData entry — opens a struct at the given tag. Use &TLVTag::Anonymous when pushed into the WriteRequests array (the typical case).

impl<P> AttrDataBuilder<P>

where P: TLVBuilderParent,

pub fn data_version(self, value: u32) -> Result<AttrDataBuilder<P, 1>, Error>

Write the optional DataVersion field — used for optimistic-concurrency writes that should fail on stale data. Omit (don’t call) for unconditional writes; subsequent path* methods are also available on state 0 and implicitly skip this field.

impl<P> AttrDataBuilder<P>

where P: TLVBuilderParent,

pub fn path( self, endpoint: u16, cluster: u32, attr: u32, ) -> Result<AttrDataBuilder<P, 2>, Error>

Write the concrete (endpoint, cluster, attribute) path, implicitly skipping DataVersion.

pub fn path_from(self, path: &AttrPath) -> Result<AttrDataBuilder<P, 2>, Error>

Write the path from an existing crate::im::AttrPath, implicitly skipping DataVersion. Used by the snapshot→streaming bridge in ImClient::write.

impl<P> AttrDataBuilder<P, 1>

where P: TLVBuilderParent,

pub fn path( self, endpoint: u16, cluster: u32, attr: u32, ) -> Result<AttrDataBuilder<P, 2>, Error>

Write the concrete (endpoint, cluster, attribute) path. This is the typical shape for attribute writes; wildcards aren’t generally meaningful for writes and aren’t exposed here. The path is encoded as a list (per spec AttributePathIB).

pub fn path_from(self, path: &AttrPath) -> Result<AttrDataBuilder<P, 2>, Error>

Write the path from an existing crate::im::AttrPath. Used by the snapshot→streaming bridge in ImClient::write so the pre-built AttrPath (which may carry wildcards or list_index) is re-emitted faithfully. New call sites should prefer Self::path.

impl<P> AttrDataBuilder<P, 2>

where P: TLVBuilderParent,

pub fn data<F>(self, f: F) -> Result<AttrDataBuilder<P, 3>, Error>

where F: FnOnce(&mut <P as TLVBuilderParent>::Write) -> Result<(), Error>,

Write the attribute value into the Data slot.

Per Matter Core spec AttributeDataIB.Data is “any TLV value.” The closure receives the parent’s TLVWrite and must emit exactly one TLV element tagged TLVTag::Context(2) (i.e. AttrDataTag::Data). The IM-level builder can’t enforce the inner type because the schema lives in the attribute the path named, not the IM message; the closure body is where the caller asserts the schema match (typically by calling a codegen-emitted typed writer).

Idiomatic call patterns:

// Any `T: ToTLV`:
.data(|w| 60u16.to_tlv(&TLVTag::Context(AttrDataTag::Data as u8), w))?

// A bool, raw:
.data(|w| w.bool(&TLVTag::Context(AttrDataTag::Data as u8), true))?

// A codegen-emitted typed helper that already knows the tag:
.data(|w| on_off::write_on_time_value(60u16, w))?

pub fn data_builder<B>(self) -> Result<B, Error>

where B: TLVBuilder<AttrDataBuilder<P, 3>>,

Open the Data slot as a typed sub-builder.

Closure-free counterpart to data — hand back the codegen-emitted typed value builder for the attribute, already opened at AttrDataTag::Data. The caller fills the value, then calls .end() on the sub-builder; that close writes Data’s closing tag (for struct/array-valued attrs) and yields an AttrDataBuilder<P, 3>. The caller then .end()s once more to close the AttrData entry struct (the “double-end” pattern of the IM-client glue).

Useful for struct- or array-valued attributes (e.g. ACL entries). For scalars prefer the closure-based [data].

Soundness of the phantom typestate advance: see [CmdDataBuilder::data_builder].

impl<P> AttrDataBuilder<P, 3>

where P: TLVBuilderParent,

pub fn end(self) -> Result<P, Error>

Close the AttrData struct and return the array builder so the caller can .push() another entry or .end() the array.

Trait Implementations

impl<P, const F: usize> Debug for AttrDataBuilder<P, F>

where P: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<P> TLVBuilder<P> for AttrDataBuilder<P>

where P: TLVBuilderParent,

fn new(parent: P, tag: &TLVTag) -> Result<AttrDataBuilder<P>, Error>

Create a new TLV builder for the given parent and tag.

fn unchecked_into_parent(self) -> P

Convert itself into a writer.

fn with<F>(self, f: F) -> Result<P, Error>

where F: FnOnce(Self) -> Result<P, Error>,

Call a closure with the builder and return the result.

impl<P, const F: usize> TLVBuilderParent for AttrDataBuilder<P, F>

where P: TLVBuilderParent,

type Write = <P as TLVBuilderParent>::Write

The type of the writer.

fn writer(&mut self) -> &mut <AttrDataBuilder<P, F> as TLVBuilderParent>::Write

Return a mutable reference to the writer.