File indexing completed on 2024-04-28 15:31:26

 /*
  *   SPDX-FileCopyrightText: 2008-2009 Petri Damstén <damu@iki.fi>
  *   SPDX-FileCopyrightText: 2014 John Layt <jlayt@kde.org>
  *
  *   SPDX-License-Identifier: LGPL-2.0-or-later
  */
 
 #ifndef KUNITCONVERSION_CONVERTER_H
 #define KUNITCONVERSION_CONVERTER_H
 
 #include <kunitconversion/kunitconversion_export.h>
 
 #include "unitcategory.h"
 
 #include <QExplicitlySharedDataPointer>
 
 namespace KUnitConversion
 {
 class Value;
 class UnitCategory;
 class ConverterPrivate;
 
 /**
  * @short Class for converting values between units of measurement
  *
  * This is a class to convert values between different units of measurement.
  *
  * @see Unit, UnitCategory, Value
  *
  * @author Petri Damstén <damu@iki.fi>
  * @author John Layt <jlayt@kde.org>
  */
 
 class KUNITCONVERSION_EXPORT Converter
 {
 public:
     /**
      * Creates a Converter instance.
      */
     Converter();
     /**
      * Destroys this Converter instance.
      */
     ~Converter();
     /**
      * Copy constructor.
      * @param other existing Converter instance.
      */
     Converter(const Converter &other);
 
     /**
      * Assignment operator, assign @p other to this.
      **/
     Converter &operator=(const Converter &other);
 
     // TODO KF6 de-inline
 #ifdef Q_COMPILER_RVALUE_REFS
     /**
      * Move-assigns @p other to this Converter instance, transferring the
      * ownership of the managed pointer to this instance.
      **/
     Converter &operator=(Converter &&other)
     {
         swap(other);
         return *this;
     }
 #endif
 
     // TODO KF6 remove
     /**
      * Swaps this Converter with @p other. This function is very fast and never fails.
      **/
     void swap(Converter &other)
     {
         d.swap(other.d);
     }
 
 #if KUNITCONVERSION_ENABLE_DEPRECATED_SINCE(5, 91)
     /**
      * @return @c true if this Converter is equal to the @p other Converter.
      * @deprecated since 5.91, result is always true
      **/
     KUNITCONVERSION_DEPRECATED_VERSION(5, 91, "result is always true")
     bool operator==(const Converter &other) const;
 
     /**
      * @return @c true if this Converter is not equal to the @p other Converter.
      * @deprecated since 5.91, result is always false
      **/
     KUNITCONVERSION_DEPRECATED_VERSION(5, 91, "result is always false")
     bool operator!=(const Converter &other) const;
 #endif
 
     /**
      * Convert value to another unit.
      *
      * @param value value to convert
      * @param toUnit unit to convert to. If empty default unit is used.
      * @return converted value
      **/
     Value convert(const Value &value, const QString &toUnit = QString()) const;
     Value convert(const Value &value, UnitId toUnit) const;
     Value convert(const Value &value, const Unit &toUnit) const;
 
     /**
      * Find unit category for unit.
      *
      * @param unit unit to find category for.
      * @return unit category for unit
      **/
     UnitCategory categoryForUnit(const QString &unit) const;
 
     /**
      * Find unit for string unit.
      *
      * @param unitString unit string to find unit for.
      * @return unit for string unit
      **/
     Unit unit(const QString &unitString) const;
 
     /**
      * Find unit for unit enum.
      *
      * @param unitId unit enum to find unit for.
      * @return unit for string unit
      **/
     Unit unit(UnitId unitId) const;
 
     /**
      * Find unit category.
      *
      * @param category name of the category to find (length, area, mass, etc.).
      * @return unit category named category or invalid category.
      **/
     UnitCategory category(const QString &category) const;
 
     /**
      * Find unit category.
      *
      * @param categoryId id of the category to find (LengthCategory, AreaCategory, etc.).
      * @return unit category which id is categoryId or invalid category.
      **/
     UnitCategory category(CategoryId categoryId) const;
 
     /**
      * Returns a list of all unit categories.
      *
      * @return list of unit categories.
      **/
     QList<UnitCategory> categories() const;
 
 private:
     QExplicitlySharedDataPointer<ConverterPrivate> d;
 };
 
 } // KUnitConversion namespace
 
 #endif