EnumI.H

Go to the documentation of this file.

/*---------------------------------------------------------------------------*\
  =========                 |
  \\      /  F ield         | OpenFOAM: The Open Source CFD Toolbox
   \\    /   O peration     |
    \\  /    A nd           | www.openfoam.com
     \\/     M anipulation  |
-------------------------------------------------------------------------------
    Copyright (C) 2017-2025 OpenCFD Ltd.
-------------------------------------------------------------------------------
License
    This file is part of OpenFOAM.
 
    OpenFOAM 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.
 
    OpenFOAM 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 OpenFOAM.  If not, see <http://www.gnu.org/licenses/>.
 
\*---------------------------------------------------------------------------*/
 
// * * * * * * * * * * * * * * * Member Functions  * * * * * * * * * * * * * //
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::empty() const noexcept
{
    return keys_.empty();
}
 
 
template<class EnumType>
inline Foam::label Foam::Enum<EnumType>::size() const noexcept
{
    return keys_.size();
}
 
 
template<class EnumType>
inline const Foam::List<Foam::word>&
Foam::Enum<EnumType>::names() const noexcept
{
    return keys_;
}
 
 
template<class EnumType>
inline const Foam::List<int>&
Foam::Enum<EnumType>::values() const noexcept
{
    return vals_;
}
 
 
template<class EnumType>
inline const Foam::List<Foam::word>&
Foam::Enum<EnumType>::toc() const noexcept
{
    return keys_;
}
 
 
template<class EnumType>
inline Foam::List<Foam::word>
Foam::Enum<EnumType>::sortedToc() const
{
    List<word> list(keys_);
 
    Foam::sort(list);
 
    return list;
}
 
 
template<class EnumType>
inline void Foam::Enum<EnumType>::clear()
{
    keys_.clear();
    vals_.clear();
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::contains(const word& key) const
{
    return (!key.empty() && keys_.contains(key));
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::contains(const EnumType e) const
{
    return vals_.contains(int(e));
}
 
 
template<class EnumType>
inline const Foam::word& Foam::Enum<EnumType>::get(const EnumType e) const
{
    const label idx = vals_.find(int(e));
 
    if (idx < 0)
    {
        return word::null;
    }
 
    return keys_[idx];
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::readIfPresent
(
    const word& key,
    const dictionary& dict,
    EnumType& val,
    const bool warnOnly
) const
{
    // Reading is non-mandatory
    return readEntry(key, dict, val, false, warnOnly);
}
 
 
template<class EnumType>
inline void Foam::Enum<EnumType>::write(const EnumType e, Ostream& os) const
{
    const label idx = vals_.find(int(e));
 
    if (idx >= 0)
    {
        os << keys_[idx];
    }
}
 
 
template<class EnumType>
template<class OS>
inline OS& Foam::Enum<EnumType>::writeList(OS& os, const label) const
{
    unsigned i = 0;
 
    os << '(';
    for (const word& k : keys_)
    {
        if (i++) os << ' ';
        os << k;
    }
    os << ')';
 
    return os;
}
 
 
// * * * * * * * * * * * * * * * * Iterators * * * * * * * * * * * * * * * * //
 
template<class EnumType>
inline Foam::Enum<EnumType>::const_iterator::const_iterator
(
    const Enum* eptr,
    const label idx
) noexcept
:
    ptr_(eptr),
    idx_(idx)
{}
 
 
template<class EnumType>
inline const Foam::word&
Foam::Enum<EnumType>::const_iterator::key() const
{
    return ptr_->names()[idx_];
}
 
 
template<class EnumType>
inline EnumType Foam::Enum<EnumType>::const_iterator::val() const
{
    return EnumType(ptr_->values()[idx_]);
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::const_iterator::good() const noexcept
{
    return (ptr_ && idx_ >= 0 && idx_ < ptr_->size());
}
 
 
template<class EnumType>
inline typename Foam::Enum<EnumType>::const_iterator&
Foam::Enum<EnumType>::const_iterator::operator++() noexcept
{
    ++idx_;
    return *this;
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::const_iterator::operator==
(
    const const_iterator& iter
) const noexcept
{
    return idx_ == iter.idx_;
}
 
 
template<class EnumType>
inline bool Foam::Enum<EnumType>::const_iterator::operator!=
(
    const const_iterator& iter
) const noexcept
{
    return idx_ != iter.idx_;
}
 
 
template<class EnumType>
inline typename Foam::Enum<EnumType>::const_iterator
Foam::Enum<EnumType>::cbegin() const noexcept
{
    return typename Enum<EnumType>::const_iterator(this);
}
 
 
template<class EnumType>
inline typename Foam::Enum<EnumType>::const_iterator
Foam::Enum<EnumType>::cend() const noexcept
{
    return typename Enum<EnumType>::const_iterator(this, this->size());
}
 
 
template<class EnumType>
inline typename Foam::Enum<EnumType>::const_iterator
Foam::Enum<EnumType>::cfind(const word& key) const
{
    const label idx = (key.empty() ? -1 : keys_.find(key));
 
    return typename Enum<EnumType>::const_iterator
    (
        this,
        (idx >= 0 ? idx : this->size())
    );
}
 
 
template<class EnumType>
inline typename Foam::Enum<EnumType>::const_iterator
Foam::Enum<EnumType>::cfind(const EnumType e) const
{
    const label idx = vals_.find(int(e));
 
    return typename Enum<EnumType>::const_iterator
    (
        this,
        (idx >= 0 ? idx : this->size())
    );
}
 
 
// * * * * * * * * * * * * * * * IOstream Operators  * * * * * * * * * * * * //
 
template<class EnumType>
inline Foam::Ostream& Foam::operator<<
(
    Ostream& os,
    const Enum<EnumType>& list
)
{
    return list.writeList(os);
}
 
 
template<class EnumType>
inline std::ostream& Foam::operator<<
(
    std::ostream& os,
    const Enum<EnumType>& list
)
{
    return list.writeList(os);
}
 
 
// ************************************************************************* //