MetaInfoInterface.h

Go to the documentation of this file.

// Copyright (c) 2002-2023, The OpenMS Team -- EKU Tuebingen, ETH Zurich, and FU Berlin
// SPDX-License-Identifier: BSD-3-Clause
//
// --------------------------------------------------------------------------
// $Maintainer: Timo Sachsenberg $
// $Authors: Marc Sturm $
// --------------------------------------------------------------------------
 
#pragma once
 
#include <vector>
 
#include <OpenMS/CONCEPT/Types.h>
#include <OpenMS/METADATA/MetaInfoRegistry.h>
#include <OpenMS/DATASTRUCTURES/DataValue.h>
 
namespace OpenMS
{
  class String;
  class MetaInfo;
 
  class OPENMS_DLLAPI MetaInfoInterface
  {
public:
 
    MetaInfoInterface();
    MetaInfoInterface(const MetaInfoInterface& rhs);
    MetaInfoInterface(MetaInfoInterface&&) noexcept;
    ~MetaInfoInterface();
 
    MetaInfoInterface& operator=(const MetaInfoInterface& rhs);
    MetaInfoInterface& operator=(MetaInfoInterface&&) noexcept;
 
    void swap(MetaInfoInterface& rhs);
 
    bool operator==(const MetaInfoInterface& rhs) const;
    bool operator!=(const MetaInfoInterface& rhs) const;
 
    const DataValue& getMetaValue(const String& name) const;
 
    DataValue getMetaValue(const String& name, const DataValue& default_value) const; // Note: return needs to be by value to prevent life-time issues at caller site (e.g. if he passes a temporary to default-value)
 
    const DataValue& getMetaValue(UInt index) const;
 
    DataValue getMetaValue(UInt index, const DataValue& default_value) const; // Note: return needs to be by value to prevent life-time issues at caller site
 
    bool metaValueExists(const String& name) const;
    bool metaValueExists(UInt index) const;
 
    void setMetaValue(const String& name, const DataValue& value);
    void setMetaValue(UInt index, const DataValue& value);
 
    void removeMetaValue(const String& name);
    void removeMetaValue(UInt index);
 
    void addMetaValues(const MetaInfoInterface& from);
 
    static MetaInfoRegistry& metaRegistry();
 
    void getKeys(std::vector<String>& keys) const;
 
    void getKeys(std::vector<UInt>& keys) const;
 
    bool isMetaEmpty() const;
 
    void clearMetaInfo();
 
protected:
 
    inline void createIfNotExists_();
 
    MetaInfo* meta_;
  };
 
} // namespace OpenMS