File: SamReferenceInfo.h

package info (click to toggle)
libstatgen 1.0.15-8
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,588 kB
  • sloc: cpp: 49,624; ansic: 1,408; makefile: 320; sh: 60
file content (87 lines) | stat: -rw-r--r-- 3,206 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
/*
 *  Copyright (C) 2010  Regents of the University of Michigan
 *
 *   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 __SAM_REFERENCE_INFO_H__
#define __SAM_REFERENCE_INFO_H__

#include "StringArray.h"
#include "StringHash.h"
#include "IntArray.h"

/// Class for tracking the reference information mapping between the
/// reference ids and the reference names.
class SamReferenceInfo
{
public:
    /// Constructor.
    SamReferenceInfo();
    /// Destructor.
    ~SamReferenceInfo();
    /// Add reference sequence name and reference sequence length.
    void add(const char* referenceSequenceName, 
             int32_t referenceSequenceLength);

    /// Get the reference ID for the specified name, if addID is set to true,
    /// a reference id will be created for the referenceName if one does not
    /// already exist, while if addID is set to false (default), it will return
    /// NO_REF_ID if the reference name does not exist.
    int getReferenceID(const String & referenceName, bool addID = false);
    /// Get the reference ID for the specified name, if addID is set to true,
    /// a reference id will be created for the referenceName if one does not
    /// already exist, while if addID is set to false (default), it will return
    /// NO_REF_ID if the reference name does not exist.
    int getReferenceID(const char* referenceName, bool addID = false);
    /// Get the reference name for the specified id, if the id is not found,
    /// return "*".
    const String & getReferenceLabel(int id) const;

    /// Get the number of entries contained here.
    int32_t getNumEntries() const;

    /// Return the reference name at the specified index, returning "" if the
    /// index is out of bounds.
    const char* getReferenceName(int index) const;
    
    /// Return the reference length at the specified index, returning 0 if the
    /// index is out of bounds.
    int32_t getReferenceLength(int index) const;

    /// Reset this reference info.
    void clear();

    /// Copy the reference information.
    SamReferenceInfo & operator = (const SamReferenceInfo & rhs);

    bool operator== (const SamReferenceInfo& rhs) const;
    bool operator!= (const SamReferenceInfo& rhs) const
    {
        return(!operator==(rhs));
    }

    /// Constant for the value returned if a reference id does not exist
    /// for a queried reference name.
    static const int NO_REF_ID = -3;

private:
    // Reference Name information
    StringArray    myReferenceContigs;
    StringIntHash  myReferenceHash;
    IntArray       myReferenceLengths;
};

#endif