workspacesettingsitem_genericvaluelist.h

Go to the documentation of this file.

/*
 * LibrePCB - Professional EDA for everyone!
 * Copyright (C) 2013 LibrePCB Developers, see AUTHORS.md for contributors.
 * https://librepcb.org/
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
#ifndef LIBREPCB_CORE_WORKSPACESETTINGSITEM_GENERICVALUELIST_H
#define LIBREPCB_CORE_WORKSPACESETTINGSITEM_GENERICVALUELIST_H
 
/*******************************************************************************
 *  Includes
 ******************************************************************************/
#include "workspacesettingsitem.h"
 
#include <librepcb/core/utils/toolbox.h>
 
#include <QtCore>
 
/*******************************************************************************
 *  Namespace / Forward Declarations
 ******************************************************************************/
namespace librepcb {
 
/*******************************************************************************
 *  Class WorkspaceSettingsItem_GenericValueList
 ******************************************************************************/
 
template <typename T, bool SerializeRaw = false>
class WorkspaceSettingsItem_GenericValueList final
  : public WorkspaceSettingsItem {
public:
  // Constructors / Destructor
  WorkspaceSettingsItem_GenericValueList() = delete;
  WorkspaceSettingsItem_GenericValueList(
      const WorkspaceSettingsItem_GenericValueList& other) = delete;
  explicit WorkspaceSettingsItem_GenericValueList(
      const QString& listKey, const QString& itemKey, const T& defaultValue,
      QObject* parent = nullptr) noexcept
    : WorkspaceSettingsItem(listKey, parent),
      mItemKey(itemKey),
      mDefaultValue(defaultValue),
      mCurrentValue(defaultValue) {}
  ~WorkspaceSettingsItem_GenericValueList() noexcept {}
 
  const T& get() const noexcept { return mCurrentValue; }
 
  bool contains(const typename T::value_type& item) const noexcept {
    return mCurrentValue.contains(item);
  }
 
  void set(const T& value) noexcept {
    if (value != mCurrentValue) {
      mCurrentValue = value;
      valueModified();
    }
  }
 
  void add(const typename T::value_type& item) noexcept {
    auto newValue = mCurrentValue;
    newValue << item;
    set(newValue);
  }
 
  const T& getDefault() const noexcept { return mDefaultValue; }
 
  // Operator Overloadings
  WorkspaceSettingsItem_GenericValueList& operator=(
      const WorkspaceSettingsItem_GenericValueList& rhs) = delete;
 
private:  // Methods
  virtual void restoreDefaultImpl() noexcept override { set(mDefaultValue); }
 
  void loadImpl(const SExpression& root) override {
    T values;  // temporary object to make this method atomic
    foreach (const SExpression* child, root.getChildren(mItemKey)) {
      if (SerializeRaw) {
        values << deserialize<typename T::value_type>(*child);
      } else {
        values << deserialize<typename T::value_type>(child->getChild("@0"));
      }
    }
    set(values);
  }
 
  T makeCanonical(const QList<typename T::value_type>& value) const noexcept {
    return value;  // Do not sort QList since the order is relevant!
  }
 
  QList<typename T::value_type> makeCanonical(
      const QSet<typename T::value_type>& value) const noexcept {
    return Toolbox::sortedQSet(value);  // Make file format canonical.
  }
 
  void serializeImpl(SExpression& root) const override {
    foreach (const auto& item, makeCanonical(mCurrentValue)) {
      root.ensureLineBreak();
      std::unique_ptr<SExpression> node = ::librepcb::serialize(item);
      if (SerializeRaw) {
        if (node->getName() != mItemKey) {
          throw LogicError(__FILE__, __LINE__);
        }
        root.appendChild(std::move(node));
      } else {
        root.appendChild(mItemKey, std::move(node));
      }
    }
    root.ensureLineBreak();
  }
 
private:
  QString mItemKey;  
  T mDefaultValue;  
  T mCurrentValue;  
};
 
/*******************************************************************************
 *  End of File
 ******************************************************************************/
 
}  // namespace librepcb
 
#endif