4.4 sdds::LayoutBuilder

• name:
  sdds::LayoutBuilder
• description:
  Build and validate a new layout using a fluent interface. Definitions are emitted in the order in which they are added.
• synopsis:
  sdds::LayoutBuilder();  
  explicit sdds::LayoutBuilder(sdds::Layout layout);  
  LayoutBuilder &setDescription(std::optional<std::string> text,  
                                std::optional<std::string> contents = {});  
  LayoutBuilder &setDataOptions(sdds::DataOptions options);  
  LayoutBuilder &addParameter(sdds::ParameterDefinition definition);  
  LayoutBuilder &addArray(sdds::ArrayDefinition definition);  
  LayoutBuilder &addColumn(sdds::ColumnDefinition definition);  
  LayoutBuilder &addAssociate(sdds::AssociateDefinition definition);  
  sdds::Layout build() const;

• arguments:
  • layout — Optional initial layout to copy into the builder.
  • text, contents — Dataset description metadata.
  • options — ASCII/binary mode, major order, byte order, row-count mode, and related header options.
  • definition — Definition to append.
• return value:
  Mutation methods return the builder for chaining. build returns a validated layout by value.
• exceptions:
  An sdds::Error-derived exception for duplicate names, invalid dimensions, unsupported versions, or inconsistent data options.
• see also:
  Sections 4.3, 4.5, and 4.18.