kim-api  2.3.1-git+v2.3.0-git-2-g378406f9.GNU.GNU.
An Application Programming Interface (API) for the Knowledgebase of Interatomic Models (KIM).
KIM_Numbering.hpp
Go to the documentation of this file.
1 //
2 // KIM-API: An API for interatomic models
3 // Copyright (c) 2013--2022, Regents of the University of Minnesota.
4 // All rights reserved.
5 //
6 // Contributors:
7 // Ryan S. Elliott
8 //
9 // SPDX-License-Identifier: LGPL-2.1-or-later
10 //
11 // This library is free software; you can redistribute it and/or
12 // modify it under the terms of the GNU Lesser General Public
13 // License as published by the Free Software Foundation; either
14 // version 2.1 of the License, or (at your option) any later version.
15 //
16 // This library is distributed in the hope that it will be useful,
17 // but WITHOUT ANY WARRANTY; without even the implied warranty of
18 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 // Lesser General Public License for more details.
20 //
21 // You should have received a copy of the GNU Lesser General Public License
22 // along with this library; if not, write to the Free Software Foundation,
23 // Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
24 //
25 
26 //
27 // Release: This file is part of the kim-api.git repository.
28 //
29 
30 
31 #ifndef KIM_NUMBERING_HPP_
32 #define KIM_NUMBERING_HPP_
33 
34 #include <string>
35 
36 namespace KIM
37 {
46 class Numbering
47 {
48  public:
59 
63  Numbering();
64 
70  Numbering(int const id);
71 
79  Numbering(std::string const & str);
80 
88  bool Known() const;
89 
97  bool operator==(Numbering const & rhs) const;
98 
106  bool operator!=(Numbering const & rhs) const;
107 
118  std::string const & ToString() const;
119 }; // class Numbering
120 
123 namespace NUMBERING
124 {
132 extern Numbering const zeroBased;
133 
141 extern Numbering const oneBased;
142 
143 
154 void GetNumberOfNumberings(int * const numberOfNumberings);
155 
169 int GetNumbering(int const index, Numbering * const numbering);
170 
175 {
180  bool operator()(Numbering const & a, Numbering const & b) const
181  {
182  return a.numberingID < b.numberingID;
183  }
184 }; // struct Comparator
185 } // namespace NUMBERING
186 } // namespace KIM
187 
188 #endif // KIM_NUMBERING_HPP_
Numbering const oneBased
The standard oneBased numbering.
bool operator()(Numbering const &a, Numbering const &b) const
Provides an (logically unmeaningful) ordering for Numbering objects so that they can be stored in a s...
bool Known() const
Determines if the object is a quantity known to the KIM API.
An Extensible Enumeration for the Numbering&#39;s supported by the KIM API.
int numberingID
Integer identifying the specific Numbering represented.
void GetNumberOfNumberings(int *const numberOfNumberings)
Get the number of standard Numbering&#39;s defined by the KIM API.
int GetNumbering(int const index, Numbering *const numbering)
Get the identity of each defined standard Numbering.
Structure provided for use with std::map.
bool operator==(Numbering const &rhs) const
Compares Numbering objects for equality.
std::string const & ToString() const
Converts the object to a string.
Numbering const zeroBased
The standard zeroBased numbering.
Numbering()
Create an uninitialized Numbering object.
bool operator!=(Numbering const &rhs) const
Compares Numbering objects for inequality.