4.8 sdds::Page typed access

• name:
  parameterAs, arrayAs, columnAs, parameterConverted, arrayConverted, columnConverted
• description:
  Read a named field either with an exact C++ type or by checked numeric conversion. Exact access returns a reference for parameters, arrays, and columns. Converted arrays and columns are returned as new vectors.
• synopsis:
  template<class T> const T &Page::parameterAs(std::string_view name) const;  
  template<class T> T Page::parameterConverted(  
      std::string_view name, sdds::RoundingMode rounding = Reject) const;  
  template<class T> const std::vector<T> &Page::arrayAs(  
      std::string_view name) const;  
  template<class T> std::vector<T> Page::arrayConverted(  
      std::string_view name, sdds::RoundingMode rounding = Reject) const;  
  template<class T> const std::vector<T> &Page::columnAs(  
      std::string_view name) const;  
  template<class T> std::vector<T> Page::columnConverted(  
      std::string_view name, sdds::RoundingMode rounding = Reject) const;

• arguments:
  • T — One of the C++ alternatives represented by the SDDS type.
  • name — Field name.
  • rounding — Floating-point-to-integer rounding policy.
• return value:
  The exact stored value or a checked converted value.
• exceptions:
  std::bad_variant_access for an inexact *As request; sdds::TypeError for a failed conversion; sdds::StateError for an unloaded field; or sdds::LimitError when transformation output exceeds the reader limit.
• see also:
  Sections 4.2 and 4.9.