4.2 sdds::convertScalar and sdds::convertValues

• name:
  sdds::convertScalar, sdds::convertValues
• description:
  Convert values between SDDS types with range and narrowing checks. Numeric overflow and invalid narrowing are rejected. Floating-point-to-integer conversion requires a rounding policy other than Reject unless the value is already an exact integer.
• synopsis:
  sdds::Scalar sdds::convertScalar(  
      const sdds::Scalar &value, sdds::Type target,  
      sdds::RoundingMode rounding = sdds::RoundingMode::Reject);  
   
  sdds::Values sdds::convertValues(  
      const sdds::Values &values, sdds::Type target,  
      sdds::RoundingMode rounding = sdds::RoundingMode::Reject);

• arguments:
  • value, values — Source scalar or homogeneous values.
  • target — Destination SDDS type.
  • rounding — Reject, TowardZero, Nearest, Down, or Up.
• return value:
  A new scalar or homogeneous values variant containing the converted data.
• exceptions:
  sdds::TypeError if a value cannot be represented or the requested conversion is invalid.
• see also:
  Sections 4.8 and 4.10.