OpenMS
DocumentIDTagger.h
Go to the documentation of this file.
1 // --------------------------------------------------------------------------
2 // OpenMS -- Open-Source Mass Spectrometry
3 // --------------------------------------------------------------------------
4 // Copyright The OpenMS Team -- Eberhard Karls University Tuebingen,
5 // ETH Zurich, and Freie Universitaet Berlin 2002-2023.
6 //
7 // This software is released under a three-clause BSD license:
8 // * Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // * Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // * Neither the name of any author or any participating institution
14 // may be used to endorse or promote products derived from this software
15 // without specific prior written permission.
16 // For a full list of authors, refer to the file AUTHORS.
17 // --------------------------------------------------------------------------
18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 // ARE DISCLAIMED. IN NO EVENT SHALL ANY OF THE AUTHORS OR THE CONTRIBUTING
22 // INSTITUTIONS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25 // OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26 // WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
27 // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
28 // ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 //
30 // --------------------------------------------------------------------------
31 // $Maintainer: Chris Bielow $
32 // $Authors: $
33 // --------------------------------------------------------------------------
34 
35 #pragma once
36 
40 
41 #include <vector>
42 
43 namespace OpenMS
44 {
54  class OPENMS_DLLAPI DocumentIDTagger
55  {
56 private:
59 
72  bool getID_(String & id, Int & free, bool idcount_only) const;
73 
74 public:
78  DocumentIDTagger(const DocumentIDTagger & source) = default;
81 
83  DocumentIDTagger & operator=(const DocumentIDTagger & source) = default;
84 
86  bool operator==(const DocumentIDTagger & source) const;
88  bool operator!=(const DocumentIDTagger & source) const;
89 
90 
98 
100  void setPoolFile(const String & file);
101 
111  bool tag(DocumentIdentifier & map) const;
112 
121  bool countFreeIDs(Int & free) const;
122 
123 protected:
126 
129  };
130 
131 } // namespace OpenMS
132 
Tags OpenMS file containers with a DocumentID.
Definition: DocumentIDTagger.h:55
DocumentIDTagger()
Constructor (declared away)
String pool_file_
location of the ID pool
Definition: DocumentIDTagger.h:128
void setPoolFile(const String &file)
Set the file used as ID pool.
bool countFreeIDs(Int &free) const
return the number of available IDs in the pool.
String toolname_
name of the calling TOPP tool
Definition: DocumentIDTagger.h:125
DocumentIDTagger(String toolname)
Constructor.
DocumentIDTagger(const DocumentIDTagger &source)=default
Copy constructor.
DocumentIDTagger & operator=(const DocumentIDTagger &source)=default
Assignment operator.
bool getID_(String &id, Int &free, bool idcount_only) const
retrieve an ID from the pool
bool tag(DocumentIdentifier &map) const
Tags any structure which is derived from DocumentIdentifier with a unique tag.
~DocumentIDTagger()
Destructor.
bool operator==(const DocumentIDTagger &source) const
Equality operator.
String getPoolFile() const
Return the file used as ID pool.
bool operator!=(const DocumentIDTagger &source) const
Equality operator.
Manage source document information.
Definition: DocumentIdentifier.h:56
A more convenient string class.
Definition: String.h:60
int Int
Signed integer type.
Definition: Types.h:102
Main OpenMS namespace.
Definition: FeatureDeconvolution.h:48